diff --git a/docs/documentation/upgrading/topics/keycloak/changes-22_0_0.adoc b/docs/documentation/upgrading/topics/keycloak/changes-22_0_0.adoc
index 95a94c6e202..e42b054c089 100644
--- a/docs/documentation/upgrading/topics/keycloak/changes-22_0_0.adoc
+++ b/docs/documentation/upgrading/topics/keycloak/changes-22_0_0.adoc
@@ -130,7 +130,7 @@ The default one for the Keycloak Admin client with Jakarta EE support is `org.ke
 
 The new artifact with Java EE support is `org.keycloak:keycloak-admin-client-jee`.
 
-=== Jakarta EE support
+== Jakarta EE support
 [source,xml]
 .Before migration:
 ----
@@ -151,7 +151,7 @@ The new artifact with Java EE support is `org.keycloak:keycloak-admin-client-jee
 </dependency>
 ----
 
-=== Java EE support
+== Java EE support
 [source,xml]
 .Before migration:
 ----
diff --git a/docs/documentation/upgrading/topics/keycloak/changes.adoc b/docs/documentation/upgrading/topics/keycloak/changes.adoc
index 4150e759bd0..229c7bf9039 100644
--- a/docs/documentation/upgrading/topics/keycloak/changes.adoc
+++ b/docs/documentation/upgrading/topics/keycloak/changes.adoc
@@ -1,8 +1,8 @@
 == Migration Changes
 
-// === Migrating to 22.0.0
-//
-// include::changes-22_0_0.adoc[leveloffset=3]
+=== Migrating to 22.0.0
+
+include::changes-22_0_0.adoc[leveloffset=3]
 
 === Migrating to 21.1.0