Skip to content

Refresh Grails 8 platform upgrade docs#15770

Open
jamesfredley wants to merge 3 commits into
8.0.xfrom
docs/grails-8-upgrade-guide-refresh
Open

Refresh Grails 8 platform upgrade docs#15770
jamesfredley wants to merge 3 commits into
8.0.xfrom
docs/grails-8-upgrade-guide-refresh

Conversation

@jamesfredley

Copy link
Copy Markdown
Contributor

Summary:

  • refresh Grails 8 docs for Spring Boot 4.1, Spring Framework 7, Java 21, Gradle, Micronaut BOMs, and JDK 25 guidance
  • align Grails Gradle plugin API docs with Micronaut BOM validation
  • support Hibernate 7 Micronaut BOM selection and add targeted TestKit coverage

Verification:

  • git diff --check
  • ./gradlew --no-daemon --max-workers=1 :grails-doc:asciidoctor
  • ./gradlew --no-daemon --max-workers=1 :grails-gradle-plugins:test --tests org.grails.gradle.plugin.core.BomPlatformFunctionalSpec

Review-gate:

  • Oracle GREEN for docs commit, BOM/API-doc commit, and full PR diff.

Document the Spring Boot 4.1 baseline, Micronaut BOM guidance, and updated Grails 8 dependency references for users moving from Grails 7.

Assisted-by: hephaestus:openai/gpt-5.5 oracle
Recognize the Hibernate 7 Micronaut BOM as a known enforced Grails BOM and cover automatic plus manual selection in the Gradle plugin functional tests.

Assisted-by: hephaestus:openai/gpt-5.5 oracle
Copilot AI review requested due to automatic review settings June 26, 2026 19:23
@jamesfredley jamesfredley self-assigned this Jun 26, 2026
@jamesfredley jamesfredley moved this to In Progress in Apache Grails Jun 26, 2026
@jamesfredley jamesfredley added this to the grails:8.0.0-M3 milestone Jun 26, 2026
@jamesfredley jamesfredley requested a review from jdaugherty June 26, 2026 19:27
@jamesfredley jamesfredley requested a review from sbglasius June 26, 2026 19:28

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Refreshes Grails 8 platform-upgrade documentation and extends the Grails Gradle plugin’s BOM handling to support the Hibernate 7 Micronaut BOM variants, with added Gradle TestKit coverage to verify enforced-platform behavior.

Changes:

  • Updates Grails 8 upgrade and “What’s New” docs for the Spring Boot 4.1 / Spring Framework 7 stack, plus Micronaut BOM guidance (including JDK 25 requirement for Micronaut-enabled apps).
  • Extends GrailsGradlePlugin BOM recognition/enforced-platform lists to include grails-hibernate7(-micronaut)-bom variants and updates extension/API documentation accordingly.
  • Adds new TestKit resource projects and functional spec assertions for Hibernate 7 Micronaut BOM selection (auto and manual declaration).

Reviewed changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
grails-gradle/plugins/src/test/resources/test-projects/bom-platform-hibernate7-micronaut-manual/settings.gradle New TestKit fixture project identity for manual Hibernate 7 Micronaut BOM case.
grails-gradle/plugins/src/test/resources/test-projects/bom-platform-hibernate7-micronaut-manual/gradle.properties New TestKit fixture property placeholder for plugin version injection.
grails-gradle/plugins/src/test/resources/test-projects/bom-platform-hibernate7-micronaut-manual/build.gradle New TestKit fixture verifying manual enforced-platform BOM declaration behavior across configurations.
grails-gradle/plugins/src/test/resources/test-projects/bom-platform-hibernate7-micronaut-auto/settings.gradle New TestKit fixture project identity for auto-selected Hibernate 7 Micronaut BOM case.
grails-gradle/plugins/src/test/resources/test-projects/bom-platform-hibernate7-micronaut-auto/gradle.properties New TestKit fixture property placeholder for plugin version injection.
grails-gradle/plugins/src/test/resources/test-projects/bom-platform-hibernate7-micronaut-auto/build.gradle New TestKit fixture verifying grails { bom = ... } selection produces an enforced platform dependency.
grails-gradle/plugins/src/test/groovy/org/grails/gradle/plugin/core/BomPlatformFunctionalSpec.groovy Adds functional coverage for Hibernate 7 Micronaut BOM selection (auto/manual).
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/core/GrailsGradlePlugin.groovy Adds Hibernate 7 BOM names to known/enforced sets and updates related messaging/comments.
grails-gradle/plugins/src/main/groovy/org/grails/gradle/plugin/core/GrailsExtension.groovy Updates extension docs to reflect Micronaut-compatible BOM validation and new Hibernate 7 Micronaut variant.
grails-doc/src/en/guide/upgrading/upgrading80x.adoc Updates upgrade guide for Spring Boot 4.1 and Micronaut BOM/enforcedPlatform guidance (plus JDK 25 Micronaut note).
grails-doc/src/en/guide/introduction/whatsNew/dependencyUpgrades.adoc Adds Java 21 baseline note and points readers to BOM variant tables.
grails-doc/src/en/guide/introduction/whatsNew.adoc Adds platform baseline + Spring Boot 4.1/Spring Framework 7 highlights.
grails-doc/src/en/guide/conf/micronaut.adoc Updates Micronaut BOM explanation and adds JDK 25 guidance for Micronaut-enabled apps.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread grails-doc/src/en/guide/conf/micronaut.adoc Outdated
@jamesfredley

Copy link
Copy Markdown
Contributor Author

Some cleanup pre-release

Clarify Micronaut BOM wording and make the Hibernate 7 Micronaut BOM TestKit fixtures exercise the grails-micronaut validation path.

Assisted-by: hephaestus:openai/gpt-5.5 oracle
@testlens-app

testlens-app Bot commented Jun 26, 2026

Copy link
Copy Markdown

✅ All tests passed ✅

🏷️ Commit: 3a1e90c
▶️ Tests: 28908 executed
⚪️ Checks: 44/44 completed


Learn more about TestLens at testlens.app.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In Progress

Development

Successfully merging this pull request may close these issues.

3 participants