From 7ec72cfd44774ce11ddfbf52a52f42ee5da0b22d Mon Sep 17 00:00:00 2001 From: James Fredley Date: Sat, 2 May 2026 08:56:40 -0400 Subject: [PATCH] docs: update RELEASE.md examples for 8.0.0-M1 The 8.0.x branch's RELEASE.md was identical to 7.0.x and still referenced v7.0.0-M4 / 7.0.x in every worked example. Update the version examples and target branch to v8.0.0-M1 / 8.0.x so the document is correct for the upcoming first 8.0.x milestone release. Also fix a few small defects discovered while reviewing the same sections: - Replace the `very-reproducible.sh` typo with the actual filename `verify-reproducible.sh`. - Adjust the manual gradle-bootstrap example to match what `verify.sh` actually does (cd into gradle-bootstrap, then run gradle). - Close the unbalanced backtick around `` in the "Appendix: Verification from a Container" section and add `v8.0.0-M1` as a concrete substitution example. - Fix `with be` -> `will be` typo in the ASF Reporter example (touched the same line as the version bump). Assisted-by: claude-code:claude-opus-4-7 --- RELEASE.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/RELEASE.md b/RELEASE.md index 4b84093b296..7995d04ce49 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -34,8 +34,8 @@ During the staging step, we must create a source distribution & stage any binary 1. Create a release in `grails-core`: * Click "Draft a new release" here: https://github.com/apache/grails-core/releases * On the draft new release screen, we execute the following steps: - * The tag will have the prefix 'v', so for our release it would be 'v7.0.0-M4' - * The "Target" will be the branch we build out of (this case it's the default, 7.0.x) + * The tag will have the prefix 'v', so for our release it would be 'v8.0.0-M1' + * The "Target" will be the branch we build out of (in this case, 8.0.x) * Previous tag will be auto * Click "Generate Release Notes" * This will then scan our commit history and we adjust the release notes per project agreement. @@ -77,7 +77,7 @@ Prior to releasing a vote, we need to verify the staged artifacts. The below sec For Example: ```bash - verify.sh v7.0.0-M4 /tmp/grails-verify + verify.sh v8.0.0-M1 /tmp/grails-verify ``` Please note that this script will perform steps that will require rebuilding the project & comparing the built artifacts @@ -132,13 +132,13 @@ To ensure checksums match the server & signatures match, run the script `etc/bin Example: ```bash - ./etc/bin/verify-jar-artifacts.sh v7.0.0-M4 + ./etc/bin/verify-jar-artifacts.sh v8.0.0-M1 ``` ### Manual Verification: Reproducible Jar Files -After all jar files are verified to be signed by a valid Grails key, we need to build a local copy to ensure the file was built with the right code base. The `very-reproducible.sh` script handles this check, but if the bootstrap needs to be manually bootstrapped, perform the following step: +After all jar files are verified to be signed by a valid Grails key, we need to build a local copy to ensure the file was built with the right code base. The `verify-reproducible.sh` script handles this check, but if the bootstrap needs to be manually bootstrapped, perform the following step from inside the downloaded source distribution: - gradle -p gradle-bootstrap + cd gradle-bootstrap && gradle Further details on the building can be found in the [INSTALL](INSTALL) document. Otherwise, run the `verify-reproducible.sh` shell script to compare the published jar files to a locally built version of them. @@ -288,7 +288,7 @@ an example call to the checked in script to move the distributions. After moving the distributions, you will receive an email from the ASF reporter. Click the link in the email to mark the release as published or go to https://reporter.apache.org/addrelease.html?grails. The `release` job in the `Release` workflow has a step to remind you of this. -For example, if the release is out of core with version `7.0.0-M4`, then the release name with be `CORE-7.0.0-M4`. Enter +For example, if the release is out of core with version `8.0.0-M1`, then the release name will be `CORE-8.0.0-M1`. Enter the date you moved the distribution artifacts and report the release. ### Deploy the release to Grails Forge @@ -383,7 +383,7 @@ Setup the key for validity: # Appendix: Verification from a Container The Grails image is officially built on linux in a GitHub action using an Ubuntu container. To run a linux container -locally, you can use the following command (substitute `` with the tag name, e.g. `v8.0.0-M1`): **macOS/Linux** ```bash