diff --git a/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc b/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc
index 887e004c6..475b1559e 100644
--- a/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc
+++ b/spring-ai-docs/src/main/antora/modules/ROOT/pages/getting-started.adoc
@@ -70,30 +70,32 @@ repositories {
}
}
----
+======
**NOTE:** When using Maven with Spring AI snapshots, pay attention to your Maven mirror configuration. If you have configured a mirror in your `settings.xml` like this:
-```xml
+[source,xml]
+----
my-mirror
*
https://my-company-repository.com/maven
-```
+----
The wildcard `*` will redirect all repository requests to your mirror, preventing access to Spring snapshot repositories. To fix this, modify the `mirrorOf` configuration to exclude Spring repositories:
-```xml
+[source,xml]
+----
my-mirror
*,!spring-snapshots,!central-portal-snapshots
https://my-company-repository.com/maven
-```
+----
This configuration allows Maven to access Spring snapshot repositories directly while still using your mirror for other dependencies.
-======
[[dependency-management]]
== Dependency Management
@@ -133,9 +135,8 @@ dependencies {
implementation 'org.springframework.ai:spring-ai-openai'
}
----
-
++
Gradle users can also use the Spring AI BOM by leveraging Gradle (5.0+) native support for declaring dependency constraints using a Maven BOM. This is implemented by adding a 'platform' dependency handler method to the dependencies section of your Gradle build script.
-
======
[[add-dependencies]]