You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by el...@apache.org on 2026/08/05 13:24:01 UTC
(maven-resolver) branch ste100-doc-rewrite created (now 119219a32)
This is an automated email from the ASF dual-hosted git repository.
elharo pushed a change to branch ste100-doc-rewrite
in repository https://gitbox.apache.org/repos/asf/maven-resolver.git
at 119219a32 docs: rewrite creating-a-repository-system-session.md to STE rules
This branch includes the following new commits:
new 119219a32 docs: rewrite creating-a-repository-system-session.md to STE rules
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
(maven-resolver) 01/01: docs: rewrite creating-a-repository-system-session.md to STE rules
Posted by el...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
elharo pushed a commit to branch ste100-doc-rewrite
in repository https://gitbox.apache.org/repos/asf/maven-resolver.git
commit 119219a32bf8851f59e64c2ad0e20cdca1ae0469
Author: Elliotte Rusty Harold <el...@ibiblio.org>
AuthorDate: Wed Aug 5 13:23:49 2026 +0000
docs: rewrite creating-a-repository-system-session.md to STE rules
---
.../creating-a-repository-system-session.md | 35 +++++++---------------
1 file changed, 10 insertions(+), 25 deletions(-)
diff --git a/src/site/markdown/creating-a-repository-system-session.md b/src/site/markdown/creating-a-repository-system-session.md
index de5f02b38..d11b80e60 100644
--- a/src/site/markdown/creating-a-repository-system-session.md
+++ b/src/site/markdown/creating-a-repository-system-session.md
@@ -18,16 +18,9 @@ specific language governing permissions and limitations
under the License.
-->
-Resolver (former Aether) and its components are designed to be stateless and as such all
-configuration/state has to be passed into the methods. When one makes
-multiple requests to resolve dependencies, a fair amount of settings
-usually remains the same across these method calls, like the proxy
-settings or the path to the local repository. Those settings that tend
-to be the same for an entire usage session of the repository system are
-represented by an instance of
-`org.eclipse.aether.RepositorySystemSession`. Using classes from
-`maven-resolver-supplier`, creating such a session that mimics Maven's
-setup can be done like this:
+Resolver (former Aether) and its components are stateless. You must pass all configuration and state into the methods. When you make multiple requests to resolve dependencies, many settings remain the same across the method calls. These settings include the proxy settings and the path to the local repository. An instance of `org.eclipse.aether.RepositorySystemSession` represents the settings that remain the same for the entire usage session of the repository system.
+
+You can create such a session with classes from `maven-resolver-supplier`. The code below creates a session that mimics the Maven setup.
```java
import org.eclipse.aether.supplier.RepositorySystemSupplier;
@@ -44,18 +37,10 @@ import org.eclipse.aether.supplier.RepositorySystemSupplier;
}
```
-As you see, the only setting that must be specified is the local
-repository, other settings are initialized with default values. Please
-have a look at the API docs for `RepositorySystemSession.SessionBuilder` to
-learn about all the other things you can configure for a session.
-
-In case of Maven plugin, or when code runs embedded in Maven, the session
-is already created for you, but you can still "derive" using copy constructor
-of `DefaultRepositorySystemSession` if some session alteration is needed.
-
-If you seek a closer cooperation with [Apache
-Maven](http://maven.apache.org/) and want to read configuration from the
-user's `settings.xml`, you should have a look at the library
-[MIMA](https://github.com/maveniverse/mima) which provides the necessary
-bits. Please direct any questions regarding usage of that library to the
-Maven mailing list.
+Only the local repository must be specified. The other settings are initialized with default values.
+
+Have a look at the API documentation for `RepositorySystemSession.SessionBuilder`. Use the documentation to learn about all the settings for a session.
+
+If you use a Maven plugin or run code embedded in Maven, the session is already created for you. You can derive a new session with the copy constructor of `DefaultRepositorySystemSession` if you must alter the session.
+
+If you use [Apache Maven](http://maven.apache.org/) and want to read configuration from the user's `settings.xml`, use the library [MIMA](https://github.com/maveniverse/mima). MIMA provides the necessary parts. Direct any questions about MIMA to the Maven mailing list.