This is an automated email from the ASF dual-hosted git repository. danhaywood pushed a commit to branch CAUSEWAY-3898 in repository https://gitbox.apache.org/repos/asf/causeway.git
commit 952bc82be8fae8d7e4c52ebf7d7f585725ad168e Author: Dan Haywood <[email protected]> AuthorDate: Wed Oct 8 13:03:21 2025 +0100 CAUSEWAY-3898: improves release docs --- .../modules/ROOT/pages/cutting-a-release.adoc | 40 +++++++++++++++++++--- 1 file changed, 36 insertions(+), 4 deletions(-) diff --git a/antora/components/comguide/modules/ROOT/pages/cutting-a-release.adoc b/antora/components/comguide/modules/ROOT/pages/cutting-a-release.adoc index 975ff035768..a67b5c5665a 100644 --- a/antora/components/comguide/modules/ROOT/pages/cutting-a-release.adoc +++ b/antora/components/comguide/modules/ROOT/pages/cutting-a-release.adoc @@ -24,16 +24,48 @@ They should work on Linux and MacOS; for Windows, use mSysGit. == Preparation -[IMPORTANT] -==== -The release process should be performed on Java 21. -==== [IMPORTANT] ==== The deploy process has been tested only with `gpg` 2.0.x ; you may need to adjust if using a later version. ==== +=== Configure JDK Toolchain + +The release process should be performed on Java 21, but using Java 17 toolchain. + +For example, if using sdkman: + +:dot: . +[source,xml] +.{dot}m2/toolchains.xml +---- +<?xml version="1.0" encoding="UTF8"?> +<toolchains> + <toolchain> + <type>jdk</type> + <provides> + <version>17</version> + <vendor>openjdk</vendor> + </provides> + <configuration> + <jdkHome>/Users/YOUR_USERNAME/.sdkman/candidates/java/17.0.10-tem</jdkHome> + </configuration> + </toolchain> + + <toolchain> + <type>jdk</type> + <provides> + <version>21</version> + <vendor>openjdk</vendor> + </provides> + <configuration> + <jdkHome>/Users/YOUR_USERNAME/.sdkman/candidates/java/21.0.2-tem</jdkHome> + </configuration> + </toolchain> +</toolchains> +---- + === Obtain Consensus Before releasing the framework, ensure there is consensus on the xref:docs:support:mailing-list.adoc[dev mailing list] that this is the right time for a release.
