diff --git a/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/features/dev-services.adoc b/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/features/dev-services.adoc
index 9dce4bc9552..2ec16e60207 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/features/dev-services.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/antora/modules/reference/pages/features/dev-services.adoc
@@ -48,9 +48,6 @@ When this module is included as a dependency Spring Boot will do the following:
 If the Docker Compose services are already running when starting the application, Spring Boot will only create the service connection beans for each supported container.
 It will not call `docker compose up` again and it will not call `docker compose stop` when the application is shutdown.
 
-NOTE: By default, Spring Boot's Docker Compose support is disabled when running tests.
-To enable it, set configprop:spring.docker.compose.skip.in-tests[] to `false`.
-
 
 
 [[features.dev-services.docker-compose.prerequisites]]
@@ -283,6 +280,25 @@ spring:
 
 
 
+[[features.dev-services.docker-compose.tests]]
+=== Using Docker Compose in Tests
+
+By default, Spring Boot's Docker Compose support is disabled when running tests.
+
+To enable Docker Compose support in tests, set configprop:spring.docker.compose.skip.in-tests[] to `false`.
+
+When using Gradle, you also need to change the configuration of the `spring-boot-docker-compose` dependency from `developmentOnly` to `testAndDevelopmentOnly`:
+
+.Gradle
+[source,gradle,indent=0,subs="verbatim"]
+----
+	dependencies {
+		testAndDevelopmentOnly("org.springframework.boot:spring-boot-docker-compose")
+	}
+----
+
+
+
 [[features.dev-services.testcontainers]]
 == Testcontainers Support