diff --git a/spring-boot-project/spring-boot-docs/pom.xml b/spring-boot-project/spring-boot-docs/pom.xml
index 57b5f031ee..640f438e6d 100644
--- a/spring-boot-project/spring-boot-docs/pom.xml
+++ b/spring-boot-project/spring-boot-docs/pom.xml
@@ -907,6 +907,7 @@
${project.groupId}:*
+ org/springframework/boot/docs/**/*.java
false
true
${basedir}/src/main/javadoc/spring-javadoc.css
diff --git a/spring-boot-project/spring-boot-docs/src/main/asciidoc/index.adoc b/spring-boot-project/spring-boot-docs/src/main/asciidoc/index.adoc
index aeafd3113a..ffbc173c03 100644
--- a/spring-boot-project/spring-boot-docs/src/main/asciidoc/index.adoc
+++ b/spring-boot-project/spring-boot-docs/src/main/asciidoc/index.adoc
@@ -61,8 +61,8 @@ Phillip Webb; Dave Syer; Josh Long; Stéphane Nicoll; Rob Winch; Andy Wilkinson;
:gradle-userguide: https://www.gradle.org/docs/current/userguide
:propdeps-plugin: https://github.com/spring-projects/gradle-plugins/tree/master/propdeps-plugin
:ant-manual: http://ant.apache.org/manual
-:code-examples: ../java/org/springframework/boot
-:test-examples: ../../test/java/org/springframework/boot
+:code-examples: ../java/org/springframework/boot/docs
+:test-examples: ../../test/java/org/springframework/boot/docs
:gradle-user-guide: https://docs.gradle.org/4.2.1/userguide
:hibernate-documentation: https://docs.jboss.org/hibernate/orm/5.2/userguide/html_single/Hibernate_User_Guide.html
:jetty-documentation: https://www.eclipse.org/jetty/documentation/9.4.x
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/ExitCodeApplication.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/ExitCodeApplication.java
similarity index 89%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/ExitCodeApplication.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/ExitCodeApplication.java
index a91e615fcd..b77707ab78 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/ExitCodeApplication.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/ExitCodeApplication.java
@@ -14,8 +14,10 @@
* limitations under the License.
*/
-package org.springframework.boot;
+package org.springframework.boot.docs;
+import org.springframework.boot.ExitCodeGenerator;
+import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/actuate/metrics/MetricsFilterBeanExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/actuate/metrics/MetricsFilterBeanExample.java
similarity index 95%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/actuate/metrics/MetricsFilterBeanExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/actuate/metrics/MetricsFilterBeanExample.java
index ef21770218..7a915e2b9e 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/actuate/metrics/MetricsFilterBeanExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/actuate/metrics/MetricsFilterBeanExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.actuate.metrics;
+package org.springframework.boot.docs.actuate.metrics;
import io.micrometer.core.instrument.config.MeterFilter;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/autoconfigure/UserService.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/autoconfigure/UserService.java
similarity index 94%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/autoconfigure/UserService.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/autoconfigure/UserService.java
index b56a8abdd4..7262ec951e 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/autoconfigure/UserService.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/autoconfigure/UserService.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.autoconfigure;
+package org.springframework.boot.docs.autoconfigure;
/**
* Sample service.
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/autoconfigure/UserServiceAutoConfiguration.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/autoconfigure/UserServiceAutoConfiguration.java
similarity index 91%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/autoconfigure/UserServiceAutoConfiguration.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/autoconfigure/UserServiceAutoConfiguration.java
index f315b0e447..a9ece58123 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/autoconfigure/UserServiceAutoConfiguration.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/autoconfigure/UserServiceAutoConfiguration.java
@@ -14,13 +14,13 @@
* limitations under the License.
*/
-package org.springframework.boot.autoconfigure;
+package org.springframework.boot.docs.autoconfigure;
-import org.springframework.boot.autoconfigure.UserServiceAutoConfiguration.UserProperties;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
+import org.springframework.boot.docs.autoconfigure.UserServiceAutoConfiguration.UserProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/builder/SpringApplicationBuilderExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/builder/SpringApplicationBuilderExample.java
similarity index 91%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/builder/SpringApplicationBuilderExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/builder/SpringApplicationBuilderExample.java
index 2fed69a2ba..fcca6abd9c 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/builder/SpringApplicationBuilderExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/builder/SpringApplicationBuilderExample.java
@@ -14,9 +14,10 @@
* limitations under the License.
*/
-package org.springframework.boot.builder;
+package org.springframework.boot.docs.builder;
import org.springframework.boot.Banner;
+import org.springframework.boot.builder.SpringApplicationBuilder;
/**
* Examples of using {@link SpringApplicationBuilder}.
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/cloudfoundry/CloudFoundryIgnorePathsExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/cloudfoundry/CloudFoundryIgnorePathsExample.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/cloudfoundry/CloudFoundryIgnorePathsExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/cloudfoundry/CloudFoundryIgnorePathsExample.java
index 3fb2ec6280..d01bdfe5f9 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/cloudfoundry/CloudFoundryIgnorePathsExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/cloudfoundry/CloudFoundryIgnorePathsExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.cloudfoundry;
+package org.springframework.boot.docs.cloudfoundry;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/context/EnvironmentPostProcessorExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/context/EnvironmentPostProcessorExample.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/context/EnvironmentPostProcessorExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/context/EnvironmentPostProcessorExample.java
index b4bb149181..48207c75ac 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/context/EnvironmentPostProcessorExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/context/EnvironmentPostProcessorExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.context;
+package org.springframework.boot.docs.context;
import java.io.IOException;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/context/embedded/TomcatLegacyCookieProcessorExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/context/embedded/TomcatLegacyCookieProcessorExample.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/context/embedded/TomcatLegacyCookieProcessorExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/context/embedded/TomcatLegacyCookieProcessorExample.java
index 13d3ee3800..63be54999b 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/context/embedded/TomcatLegacyCookieProcessorExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/context/embedded/TomcatLegacyCookieProcessorExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.context.embedded;
+package org.springframework.boot.docs.context.embedded;
import org.apache.tomcat.util.http.LegacyCookieProcessor;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/elasticsearch/HibernateSearchElasticsearchExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/elasticsearch/HibernateSearchElasticsearchExample.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/elasticsearch/HibernateSearchElasticsearchExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/elasticsearch/HibernateSearchElasticsearchExample.java
index 9d72cf0a21..904b5ad0c5 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/elasticsearch/HibernateSearchElasticsearchExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/elasticsearch/HibernateSearchElasticsearchExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.elasticsearch;
+package org.springframework.boot.docs.elasticsearch;
import javax.persistence.EntityManagerFactory;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/elasticsearch/jest/JestClientCustomizationExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/elasticsearch/jest/JestClientCustomizationExample.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/elasticsearch/jest/JestClientCustomizationExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/elasticsearch/jest/JestClientCustomizationExample.java
index bd72cfb32e..0d1bcac807 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/elasticsearch/jest/JestClientCustomizationExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/elasticsearch/jest/JestClientCustomizationExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.elasticsearch.jest;
+package org.springframework.boot.docs.elasticsearch.jest;
import io.searchbox.client.config.HttpClientConfig;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/BasicDataSourceExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/BasicDataSourceExample.java
similarity index 93%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/BasicDataSourceExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/BasicDataSourceExample.java
index ca1d39d177..2051151cfe 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/BasicDataSourceExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/BasicDataSourceExample.java
@@ -14,11 +14,12 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import javax.sql.DataSource;
import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/CompleteTwoDataSourcesExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/CompleteTwoDataSourcesExample.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/CompleteTwoDataSourcesExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/CompleteTwoDataSourcesExample.java
index 44aa151319..79c43de1e0 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/CompleteTwoDataSourcesExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/CompleteTwoDataSourcesExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import javax.sql.DataSource;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/ConfigurableDataSourceExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/ConfigurableDataSourceExample.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/ConfigurableDataSourceExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/ConfigurableDataSourceExample.java
index 3057cbb88e..fc27210eaf 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/ConfigurableDataSourceExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/ConfigurableDataSourceExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import javax.sql.DataSource;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/SimpleDataSourceExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/SimpleDataSourceExample.java
similarity index 93%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/SimpleDataSourceExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/SimpleDataSourceExample.java
index e52cf2bf22..a9b2815e4a 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/SimpleDataSourceExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/SimpleDataSourceExample.java
@@ -14,13 +14,14 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import javax.sql.DataSource;
import com.zaxxer.hikari.HikariDataSource;
import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/SimpleTwoDataSourcesExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/SimpleTwoDataSourcesExample.java
similarity index 95%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/SimpleTwoDataSourcesExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/SimpleTwoDataSourcesExample.java
index 52dfb3d88c..57d5df89e6 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/jdbc/SimpleTwoDataSourcesExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/jdbc/SimpleTwoDataSourcesExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import javax.sql.DataSource;
@@ -22,6 +22,7 @@ import org.apache.commons.dbcp2.BasicDataSource;
import org.springframework.boot.autoconfigure.jdbc.DataSourceProperties;
import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Primary;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/autoconfigure/restdocs/restassured/AdvancedConfigurationExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/autoconfigure/restdocs/restassured/AdvancedConfigurationExample.java
similarity index 94%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/autoconfigure/restdocs/restassured/AdvancedConfigurationExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/autoconfigure/restdocs/restassured/AdvancedConfigurationExample.java
index 87d9404b27..417ef7c167 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/autoconfigure/restdocs/restassured/AdvancedConfigurationExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/autoconfigure/restdocs/restassured/AdvancedConfigurationExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.test.autoconfigure.restdocs.restassured;
+package org.springframework.boot.docs.test.autoconfigure.restdocs.restassured;
import org.springframework.boot.test.autoconfigure.restdocs.RestDocsRestAssuredConfigurationCustomizer;
import org.springframework.boot.test.context.TestConfiguration;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/autoconfigure/restdocs/restassured/UserDocumentationTests.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/autoconfigure/restdocs/restassured/UserDocumentationTests.java
similarity index 95%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/autoconfigure/restdocs/restassured/UserDocumentationTests.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/autoconfigure/restdocs/restassured/UserDocumentationTests.java
index 2278543125..8d9736fae0 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/autoconfigure/restdocs/restassured/UserDocumentationTests.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/autoconfigure/restdocs/restassured/UserDocumentationTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.test.autoconfigure.restdocs.restassured;
+package org.springframework.boot.docs.test.autoconfigure.restdocs.restassured;
// tag::source[]
import io.restassured.specification.RequestSpecification;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/spock/SpockTestRestTemplateExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/spock/SpockTestRestTemplateExample.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/spock/SpockTestRestTemplateExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/spock/SpockTestRestTemplateExample.java
index da94f0e5dd..7a82c33325 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/spock/SpockTestRestTemplateExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/spock/SpockTestRestTemplateExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.test.spock;
+package org.springframework.boot.docs.test.spock;
import org.springframework.beans.factory.ObjectProvider;
import org.springframework.boot.test.context.SpringBootTest;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/web/RandomPortTestRestTemplateExampleTests.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/web/RandomPortTestRestTemplateExampleTests.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/web/RandomPortTestRestTemplateExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/web/RandomPortTestRestTemplateExampleTests.java
index 7d04c6496c..8f45565699 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/web/RandomPortTestRestTemplateExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/web/RandomPortTestRestTemplateExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.test.web;
+package org.springframework.boot.docs.test.web;
// tag::test-random-port[]
import org.junit.Test;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/web/RandomPortWebTestClientExampleTests.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/web/RandomPortWebTestClientExampleTests.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/web/RandomPortWebTestClientExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/web/RandomPortWebTestClientExampleTests.java
index 2122fbebb4..b00162ec20 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/test/web/RandomPortWebTestClientExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/test/web/RandomPortWebTestClientExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.test.web;
+package org.springframework.boot.docs.test.web;
// tag::test-random-port[]
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/web/client/RestTemplateProxyCustomizationExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/web/client/RestTemplateProxyCustomizationExample.java
similarity index 94%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/web/client/RestTemplateProxyCustomizationExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/web/client/RestTemplateProxyCustomizationExample.java
index b51aeb3b01..884cc448ff 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/web/client/RestTemplateProxyCustomizationExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/web/client/RestTemplateProxyCustomizationExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.web.client;
+package org.springframework.boot.docs.web.client;
import org.apache.http.HttpException;
import org.apache.http.HttpHost;
@@ -24,6 +24,7 @@ import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.impl.conn.DefaultProxyRoutePlanner;
import org.apache.http.protocol.HttpContext;
+import org.springframework.boot.web.client.RestTemplateCustomizer;
import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
import org.springframework.web.client.RestTemplate;
diff --git a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/web/security/UnauthenticatedAccessExample.java b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/web/security/UnauthenticatedAccessExample.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/web/security/UnauthenticatedAccessExample.java
rename to spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/web/security/UnauthenticatedAccessExample.java
index 494c2ff095..337a61031b 100644
--- a/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/web/security/UnauthenticatedAccessExample.java
+++ b/spring-boot-project/spring-boot-docs/src/main/java/org/springframework/boot/docs/web/security/UnauthenticatedAccessExample.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.web.security;
+package org.springframework.boot.docs.web.security;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/autoconfigure/UserServiceAutoConfigurationTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/autoconfigure/UserServiceAutoConfigurationTests.java
similarity index 95%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/autoconfigure/UserServiceAutoConfigurationTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/autoconfigure/UserServiceAutoConfigurationTests.java
index 20507cb250..1d284fcccd 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/autoconfigure/UserServiceAutoConfigurationTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/autoconfigure/UserServiceAutoConfigurationTests.java
@@ -14,10 +14,11 @@
* limitations under the License.
*/
-package org.springframework.boot.autoconfigure;
+package org.springframework.boot.docs.autoconfigure;
import org.junit.Test;
+import org.springframework.boot.autoconfigure.AutoConfigurations;
import org.springframework.boot.test.context.FilteredClassLoader;
import org.springframework.boot.test.context.runner.ApplicationContextRunner;
import org.springframework.context.annotation.Bean;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/builder/SpringApplicationBuilderExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/builder/SpringApplicationBuilderExampleTests.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/builder/SpringApplicationBuilderExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/builder/SpringApplicationBuilderExampleTests.java
index 4cf1952d51..70513f1d27 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/builder/SpringApplicationBuilderExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/builder/SpringApplicationBuilderExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.builder;
+package org.springframework.boot.docs.builder;
import org.junit.Rule;
import org.junit.Test;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/context/EnvironmentPostProcessorExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/context/EnvironmentPostProcessorExampleTests.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/context/EnvironmentPostProcessorExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/context/EnvironmentPostProcessorExampleTests.java
index 855e4cd325..0344a2b9ea 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/context/EnvironmentPostProcessorExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/context/EnvironmentPostProcessorExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.context;
+package org.springframework.boot.docs.context;
import org.junit.Test;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/context/embedded/TomcatLegacyCookieProcessorExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/context/embedded/TomcatLegacyCookieProcessorExampleTests.java
similarity index 92%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/context/embedded/TomcatLegacyCookieProcessorExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/context/embedded/TomcatLegacyCookieProcessorExampleTests.java
index 1a196e702f..16ae290171 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/context/embedded/TomcatLegacyCookieProcessorExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/context/embedded/TomcatLegacyCookieProcessorExampleTests.java
@@ -14,14 +14,14 @@
* limitations under the License.
*/
-package org.springframework.boot.context.embedded;
+package org.springframework.boot.docs.context.embedded;
import org.apache.catalina.Context;
import org.apache.tomcat.util.http.LegacyCookieProcessor;
import org.junit.Test;
import org.springframework.boot.SpringApplication;
-import org.springframework.boot.context.embedded.TomcatLegacyCookieProcessorExample.LegacyCookieProcessorConfiguration;
+import org.springframework.boot.docs.context.embedded.TomcatLegacyCookieProcessorExample.LegacyCookieProcessorConfiguration;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.embedded.tomcat.TomcatWebServer;
import org.springframework.boot.web.server.WebServerFactoryCustomizerBeanPostProcessor;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/BasicDataSourceExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/BasicDataSourceExampleTests.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/BasicDataSourceExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/BasicDataSourceExampleTests.java
index 5a3b0369fb..19473660cb 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/BasicDataSourceExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/BasicDataSourceExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import java.sql.SQLException;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/CompleteTwoDataSourcesExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/CompleteTwoDataSourcesExampleTests.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/CompleteTwoDataSourcesExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/CompleteTwoDataSourcesExampleTests.java
index b5dcfb0731..b44a75207a 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/CompleteTwoDataSourcesExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/CompleteTwoDataSourcesExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import java.sql.SQLException;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/ConfigurableDataSourceExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/ConfigurableDataSourceExampleTests.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/ConfigurableDataSourceExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/ConfigurableDataSourceExampleTests.java
index 1486f2fa81..73ae368f5c 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/ConfigurableDataSourceExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/ConfigurableDataSourceExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import java.sql.SQLException;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SampleApp.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SampleApp.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SampleApp.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SampleApp.java
index 786324fe6c..fb228f18f0 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SampleApp.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SampleApp.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import javax.sql.DataSource;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SimpleDataSourceExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SimpleDataSourceExampleTests.java
similarity index 97%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SimpleDataSourceExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SimpleDataSourceExampleTests.java
index 20cfcdc91d..16bfb73126 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SimpleDataSourceExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SimpleDataSourceExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import java.sql.SQLException;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SimpleTwoDataSourcesExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SimpleTwoDataSourcesExampleTests.java
similarity index 98%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SimpleTwoDataSourcesExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SimpleTwoDataSourcesExampleTests.java
index 0d7cc1516a..9cfa7de16a 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/jdbc/SimpleTwoDataSourcesExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/jdbc/SimpleTwoDataSourcesExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.jdbc;
+package org.springframework.boot.docs.jdbc;
import java.sql.SQLException;
diff --git a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/test/spock/SpockTestRestTemplateExampleTests.java b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/test/spock/SpockTestRestTemplateExampleTests.java
similarity index 96%
rename from spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/test/spock/SpockTestRestTemplateExampleTests.java
rename to spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/test/spock/SpockTestRestTemplateExampleTests.java
index 107f7e6f78..0a7c381a6a 100644
--- a/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/test/spock/SpockTestRestTemplateExampleTests.java
+++ b/spring-boot-project/spring-boot-docs/src/test/java/org/springframework/boot/docs/test/spock/SpockTestRestTemplateExampleTests.java
@@ -14,7 +14,7 @@
* limitations under the License.
*/
-package org.springframework.boot.test.spock;
+package org.springframework.boot.docs.test.spock;
import org.junit.Test;
import org.junit.runner.RunWith;