diff --git a/maven-resolver-api/src/main/java/org/eclipse/aether/RepositorySystemSession.java b/maven-resolver-api/src/main/java/org/eclipse/aether/RepositorySystemSession.java
index f6519209f..0bf8dc56d 100644
--- a/maven-resolver-api/src/main/java/org/eclipse/aether/RepositorySystemSession.java
+++ b/maven-resolver-api/src/main/java/org/eclipse/aether/RepositorySystemSession.java
@@ -194,6 +194,12 @@ interface SessionBuilder {
         /**
          * Sets the local repository manager used during this session. <em>Note:</em> Eventually, a valid session must have
          * a local repository manager set.
+         * <p>
+         * The provisioning of {@link org.eclipse.aether.repository.LocalRepositoryManager} for use with this
+         * method introduces chicken and egg situation. Integrators MUST NOT use this method, but instead, hook into
+         * Local Repository Manager Provider by any means they can (ie by using Provider or Sisu Components) and use
+         * custom string and/or priorities instead. This method existence is not meant for "everyday use" (normal
+         * session creation), but for some more advanced use cases. Do not use it, unless you know what are you doing.
          *
          * @param localRepositoryManager The local repository manager used during this session, may be {@code null}.
          * @return This session for chaining, never {@code null}.