Trim inline comments, move detail to PR description

Author: steve-aom-elliott

src/main/resources/META-INF/rewrite/hibernate-6.0.yml

@@ -48,12 +48,7 @@ description: >-
 preconditions:
   - org.openrewrite.Singleton
 recipeList:
-  # Step 1: Handle jakarta-suffixed artifacts individually (they need artifact renaming).
-  # Note: all scanners run in a single phase before any editors, so the glob scanner in
-  # step 3 still sees these at org.hibernate in its scan. However, the glob's editor runs
-  # after these editors, so it won't double-change them. The glob scanner matching these
-  # is harmless: canUpdateVariable still passes since hibernate-* matches them, and in
-  # practice jakarta and non-jakarta variants don't share version variables.
+  # Jakarta-suffixed artifacts need artifact renaming
   - org.openrewrite.java.dependencies.ChangeDependency:
       oldGroupId: org.hibernate
       oldArtifactId: hibernate-agroal-jakarta
@@ -132,26 +127,20 @@ recipeList:
       newGroupId: org.hibernate.orm
       newArtifactId: hibernate-testing
       newVersion: 6.0.x
-  # Step 2: Remove hibernate-entitymanager before the glob matches it.
-  # This artifact was removed in Hibernate 6 (merged into hibernate-core).
+  # Remove hibernate-entitymanager before the glob matches it
   - org.openrewrite.java.dependencies.RemoveDependency:
       groupId: org.hibernate
       artifactId: hibernate-entitymanager
   - org.openrewrite.maven.RemoveManagedDependency:
       groupId: org.hibernate
       artifactId: hibernate-entitymanager
-  # Step 3: Migrate all remaining org.hibernate:hibernate-* to org.hibernate.orm in a single
-  # ChangeDependency. Using a single recipe means that ChangeDependency's canUpdateVariable
-  # check sees all matching dependencies at once, so shared ext properties (e.g. hibernateVersion)
-  # are updated in place rather than being detached from some dependencies.
+  # Single glob for all remaining ORM artifacts — preserves shared version properties
   - org.openrewrite.java.dependencies.ChangeDependency:
       oldGroupId: org.hibernate
       oldArtifactId: hibernate-*
       newGroupId: org.hibernate.orm
       newVersion: 6.0.x
-  # Step 4: Revert non-ORM artifacts that the glob inadvertently matched.
-  # hibernate-validator and hibernate-search are separate projects that did not move to
-  # org.hibernate.orm. These entries restore the original groupId without changing the version.
+  # Revert non-ORM artifacts the glob inadvertently matched
   - org.openrewrite.java.dependencies.ChangeDependency:
       oldGroupId: org.hibernate.orm
       oldArtifactId: hibernate-validator