HHH-19814: Document the Enhance Plugin changes in the Migration Guide

Signed-off-by: Koen Aers <[email protected]>

Author: koentsje

migration-guide.adoc

@@ -789,3 +789,34 @@ We recommend using https://github.com/agroal/agroal[Agroal] or https://github.co
 Alternatively, you may implement the `ConnectionProvider` interface to integrate the connection pool of your choice.
 In fact, some connection pools already include their own implementations of `ConnectionProvider`.
 
+[[maven-plugin-changes]]
+== Changes to the Maven Plugin
+
+The Maven bytecode enhancement plugin has been completely rewritten since version 7.0. The change that has the
+biggest consequence is that the artefactId and groupId of the Maven artefact has changed. As of now, you will
+need to include the plugin in the build section in your Maven pom file as illustrated below.
+
+```
+<plugin>
+    <groupId>org.hibernate.orm</groupId>
+    <artifactId>hibernate-maven-plugin</artifactId>
+    <version>$currentHibernateVersion</version>
+    <executions>
+        <execution>
+            <configuration>
+                <enableLazyInitialization>true</enableLazyInitialization>
+                <enableDirtyTracking>true</enableDirtyTracking>
+            </configuration>
+            <goals>
+                <goal>enhance</goal>
+            </goals>
+        </execution>
+    </executions>
+</plugin>
+```
+
+Also, because of a regression and in contrast with the corresponding Ant task and Gradle plugin, the default values
+of the `enableLazyInitialization` and `enableDirtyTracking` are set to `false` while it used to be `true`. This will
+be reverted in future versions.
+
+The documentation in the userguide has been rewritten accordingly and completed with more examples.