diff --git a/docs/modules/ROOT/pages/README.adoc b/docs/modules/ROOT/pages/README.adoc
index 83ff3cb0..f0514cd3 100644
--- a/docs/modules/ROOT/pages/README.adoc
+++ b/docs/modules/ROOT/pages/README.adoc
@@ -5,10 +5,10 @@ image::https://api.codacy.com/project/badge/Grade/f064024a072c477e97dca6ed5a70fc
 include::intro.adoc[]
 
 [[features]]
-== Features
+= Features
 
 [[spring-cloud-config-server]]
-=== Spring Cloud Config Server
+== Spring Cloud Config Server
 
 Spring Cloud Config Server offers the following benefits:
 
@@ -17,7 +17,7 @@ Spring Cloud Config Server offers the following benefits:
 * Embeddable easily in a Spring Boot application using `@EnableConfigServer`
 
 [[spring-cloud-config-client]]
-=== Spring Cloud Config Client
+== Spring Cloud Config Client
 
 Specifically for Spring applications, Spring Cloud Config Client lets you:
 
@@ -32,12 +32,12 @@ Specifically for Spring applications, Spring Cloud Config Client lets you:
 * Bootstrap application context: a parent context for the main application that can be trained to do anything (by default, it binds to the Config Server and decrypts property values).
 
 [[quick-start]]
-== Quick Start
+= Quick Start
 
 include::quickstart.adoc[]
 
 [[sample-application]]
-=== Sample Application
+== Sample Application
 
 You can find a sample application https://github.com/spring-cloud/spring-cloud-config/tree/master/spring-cloud-config-sample[here].
 It is a Spring Boot application, so you can run it by using the usual mechanisms (for instance, `mvn spring-boot:run`).
@@ -64,12 +64,12 @@ sampleValue
 The refresh endpoint reports that the "sample" property changed.
 
 [[building]]
-== Building
+= Building
 
 include::https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/building.adoc[]
 
 [[jce]]
-=== JCE
+== JCE
 
 If you get an exception due to "Illegal key size" and you are using Sun’s JDK, you need to install the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files.
 See the following links for more information:
@@ -83,6 +83,6 @@ https://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.h
 Extract the JCE files into the `JDK/jre/lib/security` folder for whichever version of JRE/JDK x64/x86 you use.
 
 [[contributing]]
-== Contributing
+= Contributing
 
 include::https://raw.githubusercontent.com/spring-cloud/spring-cloud-build/master/docs/src/main/asciidoc/contributing.adoc[]
diff --git a/docs/modules/ROOT/pages/_observability.adoc b/docs/modules/ROOT/pages/_observability.adoc
index 01121b26..2b4083fa 100644
--- a/docs/modules/ROOT/pages/_observability.adoc
+++ b/docs/modules/ROOT/pages/_observability.adoc
@@ -1,7 +1,7 @@
 :root-target: ../../../target/
 
 [[observability]]
-== Observability metadata
+= Observability metadata
 
 include::{root-target}_metrics.adoc[]
 
diff --git a/docs/modules/ROOT/pages/quickstart.adoc b/docs/modules/ROOT/pages/quickstart.adoc
index a807a480..7b91ced3 100644
--- a/docs/modules/ROOT/pages/quickstart.adoc
+++ b/docs/modules/ROOT/pages/quickstart.adoc
@@ -78,7 +78,7 @@ spring:
 Other sources are any JDBC compatible database, Subversion, Hashicorp Vault, Credhub and local filesystems.
 
 [[client-side-usage]]
-=== Client Side Usage
+= Client Side Usage
 
 To use these features in an application, you can build it as a Spring Boot application that depends on spring-cloud-config-client (for an example, see the test cases for the config-client or the sample application).
 The most convenient way to add the dependency is with a Spring Boot starter `org.springframework.cloud:spring-cloud-starter-config`.