diff --git a/documentation/manual/src/main/asciidoc/migration/index.asciidoc b/documentation/manual/src/main/asciidoc/migration/index.asciidoc
new file mode 100644
index 0000000000..5784eb2071
--- /dev/null
+++ b/documentation/manual/src/main/asciidoc/migration/index.asciidoc
@@ -0,0 +1,28 @@
+[[ogm-migration]]
+
+== 5.4.2.Final
+
+=== MongoDB
+
+==== MongoDB Java Driver
+
+This patch release updates the underlying MongoDB Java driver from 3.11 to 4.11.  It also fixes some incompatibilities
+with more recent versions of MongoDB that prevent 5.4.1.Final from executing native queries.
+
+As a consequence of the driver update, the oldest MongoDB server release that Hibernate OGM will connect to is now 3.6 (which reached
+end of life in April 2021).
+
+=== MongoDB Server
+
+Recent versions of the MongoDB server have removed support for some features on which Hibernate OGM depend. In particular:
+
+* MongoDB 4.2 removed support for the `$eval` command, on which Hibernate OGM support for stored procedures depends.
+* MongoDB 4.0 removed support for the `$snapshot` and `$maxscan` query modifiers, and these modifiers are now ignored for
+  native queries.
+
+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).
+
+
+
+