diff --git a/documentation/manual/src/main/asciidoc/index.asciidoc b/documentation/manual/src/main/asciidoc/index.asciidoc
index ad6a0f1cc7..5236d24c02 100644
--- a/documentation/manual/src/main/asciidoc/index.asciidoc
+++ b/documentation/manual/src/main/asciidoc/index.asciidoc
@@ -18,6 +18,8 @@ include::modules/how-to-contribute.asciidoc[]
 
 include::modules/getting-started.asciidoc[]
 
+include::modules/migrating.asciidoc[]
+
 include::modules/architecture.asciidoc[]
 
 include::modules/configuration.asciidoc[]
diff --git a/documentation/manual/src/main/asciidoc/migration/index.asciidoc b/documentation/manual/src/main/asciidoc/modules/migrating.asciidoc
similarity index 93%
rename from documentation/manual/src/main/asciidoc/migration/index.asciidoc
rename to documentation/manual/src/main/asciidoc/modules/migrating.asciidoc
index d6810c160c..dee17a092d 100644
--- a/documentation/manual/src/main/asciidoc/migration/index.asciidoc
+++ b/documentation/manual/src/main/asciidoc/modules/migrating.asciidoc
@@ -1,6 +1,6 @@
-[[ogm-migration]]
+[[ogm-migrating]]
 
-== 5.4.2.Final
+== Migrating from 5.4.1.Final
 
 === MongoDB
 
@@ -23,8 +23,7 @@ Recent versions of the MongoDB server have removed support for some features on
 All other Hibernate OGM tests of MongoDB support are passing with MongoDB 3.6, up through the latest release of MongoDB
 (currently MongoDB 8.0).
 
-== Older versions
+=== Older versions
 
 The migration guide for the previous versions of Hibernate OGM is available on the
-https://developer.jboss.org/docs/DOC-52281[JBoss Community Archive] website.
-
+https://developer.jboss.org/docs/DOC-52281[JBoss Community Archive] website.
\ No newline at end of file