Add migration guide.

Author: christophstrobl

src/main/antora/modules/ROOT/nav.adoc

@@ -3,6 +3,7 @@
 ** xref:migration-guides.adoc[]
 *** xref:migration-guide/migration-guide-2.x-to-3.x.adoc[]
 *** xref:migration-guide/migration-guide-3.x-to-4.x.adoc[]
+*** xref:migration-guide/migration-guide-4.x-to-5.x.adoc[]
 
 * xref:mongodb.adoc[]
 ** xref:preface.adoc[]

src/main/antora/modules/ROOT/pages/migration-guide/migration-guide-4.x-to-5.x.adoc

@@ -0,0 +1,38 @@
+[[mongodb.migration.4.x-5.x]]
+= Migration Guide from 4.x to 5.x
+
+Spring Data MongoDB 4.x requires the MongoDB Java Driver 5.5.x +
+To learn more about driver versions please visit the https://www.mongodb.com/docs/drivers/java/sync/current/upgrade/[MongoDB Documentation].
+
+== UUID Representation Changes
+
+Spring Data no longer defaults UUID settings via its configuration support classes, factory beans, nor XML namespace. +
+In order to persist UUID values the `UuidRepresentation` hast to be set explicitly.
+
+[tabs]
+======
+Java::
++
+[source,java,indent=0,subs="verbatim,quotes",role="primary"]
+----
+@Configuration
+static class Config extends AbstractMongoClientConfiguration {
+
+	@Override
+	protected void configureClientSettings(Builder builder) {
+		builder.uuidRepresentation(UuidRepresentation.STANDARD);
+	}
+
+    // ...
+}
+----
+
+XML::
++
+[source,xml,indent=0,subs="verbatim,quotes",role="secondary"]
+----
+<mongo:mongo-client>
+	<mongo:client-settings uuid-representation="STANDARD"/>
+</mongo:mongo-client>
+----
+======