render migration guide using asciidoctor and publish with docs

documentation/documentation.gradle

@@ -192,6 +192,34 @@ task renderIntegrationGuide(type: AsciidoctorTask, group: 'Documentation') {task
 	}
 }
 
+
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// Migration Guide
+
+task renderMigrationGuide(type: AsciidoctorTask, group: 'Documentation') {task->
+	description = 'Renders the Migration Guide in HTML format using Asciidoctor.'
+	tasks.buildDocsForPublishing.dependsOn task
+
+	sourceDir = rootProject.layout.projectDirectory
+	sources {
+		include 'migration-guide.adoc'
+	}
+
+	outputDir = project.layout.buildDirectory.dir( 'asciidoc/migration-guide' )
+
+	attributes linkcss: true,
+			stylesheet: "css/hibernate.css"
+
+	resources {
+		from('src/main/style/asciidoctor') {
+			include 'images/**'
+		}
+		from('src/main/style/asciidoctor') {
+			include 'css/**'
+		}
+	}
+}
+
 tasks.withType(AsciidoctorTask).all {
 	baseDirFollowsSourceDir()
 	outputOptions {

migration-guide.adoc

@@ -7,11 +7,12 @@
 :fn-converter: footnote:converter[Think `AttributeConverter`]
 
 
-
-
 This guide discusses migration from Hibernate ORM version 6.0.  For migration from
 earlier versions, see any other pertinent migration guides as well.
 
+== Java 11
+
+With 6.0, Hibernate ORM has moved to expect Java 11 as its baseline version.
 
 
 == Jakarta Persistence
@@ -35,11 +36,6 @@ in migration.  It logs a deprecation warning when the Java EE variants are used.
 directory in the project root for the configuration used to migrate Hibernate itself.
 
 
-== Java 11
-
-With 6.0, Hibernate ORM has moved to expect Java 11 as its baseline version
-
-
 [[read-jdbc]]
 == Reading from JDBC