This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/causeway.git
The following commit(s) were added to refs/heads/main by this push:
new b7002f08b6c updates release docs
b7002f08b6c is described below
commit b7002f08b6cdcac11461d2fbc76c36409fc1a0a7
Author: Dan Haywood <[email protected]>
AuthorDate: Tue Jul 8 19:22:58 2025 +0100
updates release docs
---
.../ROOT/pages/post-release-successful.adoc | 55 ++++++++++++++++++++++
1 file changed, 55 insertions(+)
diff --git
a/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
b/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
index 74918cf3176..fd5b348e282 100644
--- a/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
+++ b/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
@@ -598,6 +598,61 @@ Now that the release is complete, tidy up these branches
and then set up the `-S
IMPORTANT: The `vN-{jpa,jdo}` branches should always work against the most
recent release, whereas the `vN-{jpa,jdo}-SNAPSHOT` reference more recent
nightly builds if necessary.
+== Update the petclinic app
+
+The link:https://github.com/apache/causeway-app-petclinic[petclinic tutorial
app] should be updated with example tags for each of its exercises.
+
+* Checkout the repo
+
+* Create a new branch
++
+[source,bash,subs="attributes+"]
+----
+git checkout -b {page-causewayreleaseversion}
+----
+
+* Reset to the `v3` branch, which contains the scripts required to create the
new tags.
++
+[source,bash,subs="attributes+"]
+----
+git reset --hard v3
+----
+
+* Set the version using the `setver.sh` script (basically just runs `mvn
versions:set`).
++
+[source,bash,subs="attributes+"]
+----
+./setver.sh -v {page-causewayreleaseversion}
+----
+
+* Create the new tags using `tagger.sh`:
++
+[source,bash,subs="attributes+"]
+----
+PREV_VERSION=... # <.>
+./tagger.sh -p $PREV_VERSION -v {page-causewayreleaseversion}
+----
+<.> adjust as necessary; should be the immediately previous version, eg
`3.3.0` precedes `3.4.0`.
+
+* confirm that the last tag builds and runs ok.
++
+If it doesn't, identify where the problem arises, and fix it.
++
+[TIP]
+====
+The 05-01 tag is broken due to mvn versions not set at that point; but 05-02
should work.
+====
+
+* Push the tags:
++
+[source,bash,subs="attributes+"]
+----
+for a in `git tag -l | grep {page-causewayreleaseversion}`
+do
+ git push origin $a
+done
+----
+
== Update the reference app
The link:https://github.com/apache/causeway-app-referenceapp[reference app]
has a configuration property `causeway.viewer.common.application.version` (in
link:https://github.com/apache/causeway-app-referenceapp/blob/master/domain/src/main/resources/application.yml#L91[application.yml]);
this should be updated.
