You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@causeway.apache.org by da...@apache.org on 2023/10/09 22:14:40 UTC

[causeway] branch 2.0.0-RC3 updated (e72e77b94d -> 6155f3b42f)

This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a change to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git


 discard e72e77b94d CAUSEWAY-3528 : updates site.yml
     new deb1db7c22 CAUSEWAY-3528 : adds site.NEXT.yml
     new d4caeaed79 CAUSEWAY-3528 : updates generated doc
     new 853e463385 : updates release notes, STATUS and doap_causeway.rdf
     new f912ffde95 CAUSEWAY-3528: updates release notes, STATUS and doap_causeway.rdf
     new 81d5c615c6 CAUSEWAY-3528: improves release docs, trivial
     new e0140b654c CAUSEWAY-3528: improves release docs
     new c5d181a034 CAUSEWAY-3528: improves release docs
     new 6155f3b42f CAUSEWAY-3528: bumps antora.yml versions to 2.0.0-RC3

This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version.  This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:

 * -- * -- B -- O -- O -- O   (e72e77b94d)
            \
             N -- N -- N   refs/heads/2.0.0-RC3 (6155f3b42f)

You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.

Any revisions marked "omit" are not gone; other references still
refer to them.  Any revisions marked "discard" are gone forever.

The 8 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 STATUS                                             |   2 +
 antora/components/comguide/antora.yml              |   2 +-
 .../modules/ROOT/pages/cutting-a-release.adoc      | 109 +++-----
 .../ROOT/pages/post-release-successful.adoc        | 142 +++++++---
 antora/components/conguide/antora.yml              |   2 +-
 antora/components/docs/antora.yml                  |   2 +-
 antora/components/refguide-index/antora.yml        |   2 +-
 antora/components/refguide/antora.yml              |   2 +-
 antora/components/relnotes/antora.yml              |   2 +-
 antora/components/relnotes/modules/ROOT/nav.adoc   |   1 +
 .../ROOT/pages/2023/2.0.0-RC2/mignotes.adoc        |   1 -
 .../ROOT/pages/2023/2.0.0-RC3/relnotes.adoc        | 132 ++++++++-
 .../ROOT/pages/2024/2.0.0-RC4/mignotes.adoc}       |   4 +-
 .../ROOT/pages/2024/2.0.0-RC4/relnotes.adoc}       |   4 +-
 .../relnotes/modules/ROOT/pages/about.adoc         |  14 +-
 antora/components/setupguide/antora.yml            |   2 +-
 antora/components/tutorials/antora.yml             |   2 +-
 antora/components/userguide/antora.yml             |   2 +-
 antora/playbooks/{site.yml => site.NEXT.yml}       | 142 +++++-----
 antora/playbooks/site.ORIG.yml                     | 302 ---------------------
 antora/playbooks/site.yml                          | 146 +++++-----
 antora/supplemental-ui/doap_causeway.rdf           |   8 +
 api/schema/src/main/adoc/antora.yml                |   2 +-
 commons/src/main/adoc/antora.yml                   |   2 +-
 core/adoc/antora.yml                               |   2 +-
 core/adoc/modules/_overview/pages/about.adoc       |  54 +---
 core/codegen-bytebuddy/src/main/adoc/antora.yml    |   2 +-
 core/config/src/main/adoc/antora.yml               |   2 +-
 core/interaction/src/main/adoc/antora.yml          |   2 +-
 core/internaltestsupport/src/main/adoc/antora.yml  |   2 +-
 core/metamodel/src/main/adoc/antora.yml            |   2 +-
 core/runtime/src/main/adoc/antora.yml              |   2 +-
 core/runtimeservices/src/main/adoc/antora.yml      |   2 +-
 core/security/src/main/adoc/antora.yml             |   2 +-
 core/transaction/src/main/adoc/antora.yml          |   2 +-
 core/webapp/src/main/adoc/antora.yml               |   2 +-
 extensions/adoc/antora.yml                         |   2 +-
 extensions/core/commandlog/adoc/antora.yml         |   2 +-
 extensions/core/docgen/adoc/antora.yml             |   2 +-
 extensions/core/excel/adoc/antora.yml              |   2 +-
 extensions/core/executionlog/adoc/antora.yml       |   2 +-
 .../core/executionlog/adoc/modules/antora.yml      |   2 +-
 extensions/core/executionoutbox/adoc/antora.yml    |   2 +-
 .../core/executionoutbox/adoc/modules/antora.yml   |   2 +-
 .../core/executionrepublisher/adoc/antora.yml      |   2 +-
 extensions/core/flyway/adoc/antora.yml             |   2 +-
 extensions/security/audittrail/adoc/antora.yml     |   2 +-
 extensions/security/secman/adoc/antora.yml         |   2 +-
 extensions/security/sessionlog/adoc/antora.yml     |   2 +-
 .../spring-oauth2/src/main/adoc/antora.yml         |   2 +-
 extensions/vro/cors/adoc/antora.yml                |   2 +-
 extensions/vw/exceldownload/adoc/antora.yml        |   2 +-
 extensions/vw/fullcalendar/adoc/antora.yml         |   2 +-
 extensions/vw/pdfjs/adoc/antora.yml                |   2 +-
 extensions/vw/sse/adoc/antora.yml                  |   2 +-
 incubator/adoc/antora.yml                          |   2 +-
 .../extensions/core/commandreplay/adoc/antora.yml  |   2 +-
 incubator/viewers/graphql/adoc/antora.yml          |   2 +-
 mavendeps/adoc/antora.yml                          |   2 +-
 persistence/jdo/adoc/antora.yml                    |   2 +-
 persistence/jpa/adoc/antora.yml                    |   2 +-
 regressiontests/adoc/antora.yml                    |   2 +-
 security/adoc/antora.yml                           |   2 +-
 security/bypass/src/main/adoc/antora.yml           |   2 +-
 security/keycloak/src/main/adoc/antora.yml         |   2 +-
 security/shiro/src/main/adoc/antora.yml            |   2 +-
 security/spring/src/main/adoc/antora.yml           |   2 +-
 starters/adoc/antora.yml                           |   2 +-
 testing/adoc/antora.yml                            |   2 +-
 testing/archtestsupport/adoc/antora.yml            |   2 +-
 testing/fakedata/adoc/antora.yml                   |   2 +-
 testing/fixtures/adoc/antora.yml                   |   2 +-
 testing/h2console/adoc/antora.yml                  |   2 +-
 testing/hsqldbmgr/adoc/antora.yml                  |   2 +-
 testing/integtestsupport/adoc/antora.yml           |   2 +-
 testing/specsupport/adoc/antora.yml                |   2 +-
 testing/unittestsupport/adoc/antora.yml            |   2 +-
 tooling/adoc/antora.yml                            |   2 +-
 tooling/cli/adoc/antora.yml                        |   2 +-
 valuetypes/adoc/antora.yml                         |   2 +-
 valuetypes/asciidoc/adoc/antora.yml                |   2 +-
 valuetypes/jodatime/adoc/antora.yml                |   2 +-
 valuetypes/markdown/adoc/antora.yml                |   2 +-
 valuetypes/vega/adoc/antora.yml                    |   2 +-
 viewers/restfulobjects/adoc/antora.yml             |   2 +-
 viewers/wicket/adoc/antora.yml                     |   2 +-
 86 files changed, 516 insertions(+), 689 deletions(-)
 copy antora/components/{refguide/modules/applib-classes/partials/layout/column-order.adoc => relnotes/modules/ROOT/pages/2024/2.0.0-RC4/mignotes.adoc} (90%)
 copy antora/components/{userguide/modules/ROOT/pages/meta-annotations.adoc => relnotes/modules/ROOT/pages/2024/2.0.0-RC4/relnotes.adoc} (94%)
 copy antora/playbooks/{site.yml => site.NEXT.yml} (78%)
 delete mode 100644 antora/playbooks/site.ORIG.yml


[causeway] 08/08: CAUSEWAY-3528: bumps antora.yml versions to 2.0.0-RC3

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit 6155f3b42fed9b898b65751ac6b74a37cc8af437
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 9 23:14:06 2023 +0100

    CAUSEWAY-3528: bumps antora.yml versions to 2.0.0-RC3
---
 antora/components/comguide/antora.yml                      | 2 +-
 antora/components/conguide/antora.yml                      | 2 +-
 antora/components/docs/antora.yml                          | 2 +-
 antora/components/refguide-index/antora.yml                | 2 +-
 antora/components/refguide/antora.yml                      | 2 +-
 antora/components/relnotes/antora.yml                      | 2 +-
 antora/components/setupguide/antora.yml                    | 2 +-
 antora/components/tutorials/antora.yml                     | 2 +-
 antora/components/userguide/antora.yml                     | 2 +-
 api/schema/src/main/adoc/antora.yml                        | 2 +-
 commons/src/main/adoc/antora.yml                           | 2 +-
 core/adoc/antora.yml                                       | 2 +-
 core/codegen-bytebuddy/src/main/adoc/antora.yml            | 2 +-
 core/config/src/main/adoc/antora.yml                       | 2 +-
 core/interaction/src/main/adoc/antora.yml                  | 2 +-
 core/internaltestsupport/src/main/adoc/antora.yml          | 2 +-
 core/metamodel/src/main/adoc/antora.yml                    | 2 +-
 core/runtime/src/main/adoc/antora.yml                      | 2 +-
 core/runtimeservices/src/main/adoc/antora.yml              | 2 +-
 core/security/src/main/adoc/antora.yml                     | 2 +-
 core/transaction/src/main/adoc/antora.yml                  | 2 +-
 core/webapp/src/main/adoc/antora.yml                       | 2 +-
 extensions/adoc/antora.yml                                 | 2 +-
 extensions/core/commandlog/adoc/antora.yml                 | 2 +-
 extensions/core/docgen/adoc/antora.yml                     | 2 +-
 extensions/core/excel/adoc/antora.yml                      | 2 +-
 extensions/core/executionlog/adoc/antora.yml               | 2 +-
 extensions/core/executionlog/adoc/modules/antora.yml       | 2 +-
 extensions/core/executionoutbox/adoc/antora.yml            | 2 +-
 extensions/core/executionoutbox/adoc/modules/antora.yml    | 2 +-
 extensions/core/executionrepublisher/adoc/antora.yml       | 2 +-
 extensions/core/flyway/adoc/antora.yml                     | 2 +-
 extensions/security/audittrail/adoc/antora.yml             | 2 +-
 extensions/security/secman/adoc/antora.yml                 | 2 +-
 extensions/security/sessionlog/adoc/antora.yml             | 2 +-
 extensions/security/spring-oauth2/src/main/adoc/antora.yml | 2 +-
 extensions/vro/cors/adoc/antora.yml                        | 2 +-
 extensions/vw/exceldownload/adoc/antora.yml                | 2 +-
 extensions/vw/fullcalendar/adoc/antora.yml                 | 2 +-
 extensions/vw/pdfjs/adoc/antora.yml                        | 2 +-
 extensions/vw/sse/adoc/antora.yml                          | 2 +-
 incubator/adoc/antora.yml                                  | 2 +-
 incubator/extensions/core/commandreplay/adoc/antora.yml    | 2 +-
 incubator/viewers/graphql/adoc/antora.yml                  | 2 +-
 mavendeps/adoc/antora.yml                                  | 2 +-
 persistence/jdo/adoc/antora.yml                            | 2 +-
 persistence/jpa/adoc/antora.yml                            | 2 +-
 regressiontests/adoc/antora.yml                            | 2 +-
 security/adoc/antora.yml                                   | 2 +-
 security/bypass/src/main/adoc/antora.yml                   | 2 +-
 security/keycloak/src/main/adoc/antora.yml                 | 2 +-
 security/shiro/src/main/adoc/antora.yml                    | 2 +-
 security/spring/src/main/adoc/antora.yml                   | 2 +-
 starters/adoc/antora.yml                                   | 2 +-
 testing/adoc/antora.yml                                    | 2 +-
 testing/archtestsupport/adoc/antora.yml                    | 2 +-
 testing/fakedata/adoc/antora.yml                           | 2 +-
 testing/fixtures/adoc/antora.yml                           | 2 +-
 testing/h2console/adoc/antora.yml                          | 2 +-
 testing/hsqldbmgr/adoc/antora.yml                          | 2 +-
 testing/integtestsupport/adoc/antora.yml                   | 2 +-
 testing/specsupport/adoc/antora.yml                        | 2 +-
 testing/unittestsupport/adoc/antora.yml                    | 2 +-
 tooling/adoc/antora.yml                                    | 2 +-
 tooling/cli/adoc/antora.yml                                | 2 +-
 valuetypes/adoc/antora.yml                                 | 2 +-
 valuetypes/asciidoc/adoc/antora.yml                        | 2 +-
 valuetypes/jodatime/adoc/antora.yml                        | 2 +-
 valuetypes/markdown/adoc/antora.yml                        | 2 +-
 valuetypes/vega/adoc/antora.yml                            | 2 +-
 viewers/restfulobjects/adoc/antora.yml                     | 2 +-
 viewers/wicket/adoc/antora.yml                             | 2 +-
 72 files changed, 72 insertions(+), 72 deletions(-)

diff --git a/antora/components/comguide/antora.yml b/antora/components/comguide/antora.yml
index 9551f2a38b..af67a44992 100644
--- a/antora/components/comguide/antora.yml
+++ b/antora/components/comguide/antora.yml
@@ -17,7 +17,7 @@
 
 name: comguide
 title: "Committers' Guide"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/antora/components/conguide/antora.yml b/antora/components/conguide/antora.yml
index 057398dd70..42eb18c88c 100644
--- a/antora/components/conguide/antora.yml
+++ b/antora/components/conguide/antora.yml
@@ -17,7 +17,7 @@
 
 name: conguide
 title: "Contributors' Guide"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/antora/components/docs/antora.yml b/antora/components/docs/antora.yml
index b8b03a35d1..e9d496a756 100644
--- a/antora/components/docs/antora.yml
+++ b/antora/components/docs/antora.yml
@@ -17,7 +17,7 @@
 
 name: docs
 title: " "
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/antora/components/refguide-index/antora.yml b/antora/components/refguide-index/antora.yml
index 60e96cf28a..6b33415ec5 100644
--- a/antora/components/refguide-index/antora.yml
+++ b/antora/components/refguide-index/antora.yml
@@ -16,7 +16,7 @@
 #  under the License.
 
 name: refguide
-version: latest
+version: 2.0.0-RC3
 
 
 
diff --git a/antora/components/refguide/antora.yml b/antora/components/refguide/antora.yml
index 86ade944c7..6f88628a4f 100644
--- a/antora/components/refguide/antora.yml
+++ b/antora/components/refguide/antora.yml
@@ -17,7 +17,7 @@
 
 name: refguide
 title: "Reference Guide"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/antora/components/relnotes/antora.yml b/antora/components/relnotes/antora.yml
index eb0cb20477..2cd6a23dac 100644
--- a/antora/components/relnotes/antora.yml
+++ b/antora/components/relnotes/antora.yml
@@ -17,7 +17,7 @@
 
 name: relnotes
 title: "Release Notes"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/antora/components/setupguide/antora.yml b/antora/components/setupguide/antora.yml
index 18768b2d3c..aa7cffc472 100644
--- a/antora/components/setupguide/antora.yml
+++ b/antora/components/setupguide/antora.yml
@@ -17,7 +17,7 @@
 
 name: setupguide
 title: "Setup Guide"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/antora/components/tutorials/antora.yml b/antora/components/tutorials/antora.yml
index 0352027dbf..cd1b8831db 100644
--- a/antora/components/tutorials/antora.yml
+++ b/antora/components/tutorials/antora.yml
@@ -17,7 +17,7 @@
 
 name: tutorials
 title: "Tutorials"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
   - modules/ROOT/nav.adoc
diff --git a/antora/components/userguide/antora.yml b/antora/components/userguide/antora.yml
index 70880f4d83..b5857a6658 100644
--- a/antora/components/userguide/antora.yml
+++ b/antora/components/userguide/antora.yml
@@ -17,7 +17,7 @@
 
 name: userguide
 title: "User Guide"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/api/schema/src/main/adoc/antora.yml b/api/schema/src/main/adoc/antora.yml
index 847bc30a71..a67420f470 100644
--- a/api/schema/src/main/adoc/antora.yml
+++ b/api/schema/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: refguide
-version: latest
+version: 2.0.0-RC3
diff --git a/commons/src/main/adoc/antora.yml b/commons/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/commons/src/main/adoc/antora.yml
+++ b/commons/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/adoc/antora.yml b/core/adoc/antora.yml
index f1f3633c6c..da672398ba 100644
--- a/core/adoc/antora.yml
+++ b/core/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: core
 title: "Design Docs"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/core/codegen-bytebuddy/src/main/adoc/antora.yml b/core/codegen-bytebuddy/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/codegen-bytebuddy/src/main/adoc/antora.yml
+++ b/core/codegen-bytebuddy/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/config/src/main/adoc/antora.yml b/core/config/src/main/adoc/antora.yml
index 847bc30a71..a67420f470 100644
--- a/core/config/src/main/adoc/antora.yml
+++ b/core/config/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: refguide
-version: latest
+version: 2.0.0-RC3
diff --git a/core/interaction/src/main/adoc/antora.yml b/core/interaction/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/interaction/src/main/adoc/antora.yml
+++ b/core/interaction/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/internaltestsupport/src/main/adoc/antora.yml b/core/internaltestsupport/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/internaltestsupport/src/main/adoc/antora.yml
+++ b/core/internaltestsupport/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/metamodel/src/main/adoc/antora.yml b/core/metamodel/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/metamodel/src/main/adoc/antora.yml
+++ b/core/metamodel/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/runtime/src/main/adoc/antora.yml b/core/runtime/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/runtime/src/main/adoc/antora.yml
+++ b/core/runtime/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/runtimeservices/src/main/adoc/antora.yml b/core/runtimeservices/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/runtimeservices/src/main/adoc/antora.yml
+++ b/core/runtimeservices/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/security/src/main/adoc/antora.yml b/core/security/src/main/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/core/security/src/main/adoc/antora.yml
+++ b/core/security/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/core/transaction/src/main/adoc/antora.yml b/core/transaction/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/transaction/src/main/adoc/antora.yml
+++ b/core/transaction/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/core/webapp/src/main/adoc/antora.yml b/core/webapp/src/main/adoc/antora.yml
index 1a59920126..f6d19b9a0b 100644
--- a/core/webapp/src/main/adoc/antora.yml
+++ b/core/webapp/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: core
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/adoc/antora.yml b/extensions/adoc/antora.yml
index f8e2599875..ae5e5a032c 100644
--- a/extensions/adoc/antora.yml
+++ b/extensions/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: extensions
 title: "Extensions"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/extensions/core/commandlog/adoc/antora.yml b/extensions/core/commandlog/adoc/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/commandlog/adoc/antora.yml
+++ b/extensions/core/commandlog/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/docgen/adoc/antora.yml b/extensions/core/docgen/adoc/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/docgen/adoc/antora.yml
+++ b/extensions/core/docgen/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/excel/adoc/antora.yml b/extensions/core/excel/adoc/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/excel/adoc/antora.yml
+++ b/extensions/core/excel/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/executionlog/adoc/antora.yml b/extensions/core/executionlog/adoc/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/executionlog/adoc/antora.yml
+++ b/extensions/core/executionlog/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/executionlog/adoc/modules/antora.yml b/extensions/core/executionlog/adoc/modules/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/executionlog/adoc/modules/antora.yml
+++ b/extensions/core/executionlog/adoc/modules/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/executionoutbox/adoc/antora.yml b/extensions/core/executionoutbox/adoc/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/executionoutbox/adoc/antora.yml
+++ b/extensions/core/executionoutbox/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/executionoutbox/adoc/modules/antora.yml b/extensions/core/executionoutbox/adoc/modules/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/executionoutbox/adoc/modules/antora.yml
+++ b/extensions/core/executionoutbox/adoc/modules/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/executionrepublisher/adoc/antora.yml b/extensions/core/executionrepublisher/adoc/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/executionrepublisher/adoc/antora.yml
+++ b/extensions/core/executionrepublisher/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/core/flyway/adoc/antora.yml b/extensions/core/flyway/adoc/antora.yml
index 448d819e20..010eb398a6 100644
--- a/extensions/core/flyway/adoc/antora.yml
+++ b/extensions/core/flyway/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: userguide
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/security/audittrail/adoc/antora.yml b/extensions/security/audittrail/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/extensions/security/audittrail/adoc/antora.yml
+++ b/extensions/security/audittrail/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/security/secman/adoc/antora.yml b/extensions/security/secman/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/extensions/security/secman/adoc/antora.yml
+++ b/extensions/security/secman/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/security/sessionlog/adoc/antora.yml b/extensions/security/sessionlog/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/extensions/security/sessionlog/adoc/antora.yml
+++ b/extensions/security/sessionlog/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/security/spring-oauth2/src/main/adoc/antora.yml b/extensions/security/spring-oauth2/src/main/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/extensions/security/spring-oauth2/src/main/adoc/antora.yml
+++ b/extensions/security/spring-oauth2/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/vro/cors/adoc/antora.yml b/extensions/vro/cors/adoc/antora.yml
index c83b9c2982..739fbf1f15 100644
--- a/extensions/vro/cors/adoc/antora.yml
+++ b/extensions/vro/cors/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: vro
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/vw/exceldownload/adoc/antora.yml b/extensions/vw/exceldownload/adoc/antora.yml
index c1675fed61..c05c37e182 100644
--- a/extensions/vw/exceldownload/adoc/antora.yml
+++ b/extensions/vw/exceldownload/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: vw
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/vw/fullcalendar/adoc/antora.yml b/extensions/vw/fullcalendar/adoc/antora.yml
index c1675fed61..c05c37e182 100644
--- a/extensions/vw/fullcalendar/adoc/antora.yml
+++ b/extensions/vw/fullcalendar/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: vw
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/vw/pdfjs/adoc/antora.yml b/extensions/vw/pdfjs/adoc/antora.yml
index c1675fed61..c05c37e182 100644
--- a/extensions/vw/pdfjs/adoc/antora.yml
+++ b/extensions/vw/pdfjs/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: vw
-version: latest
+version: 2.0.0-RC3
diff --git a/extensions/vw/sse/adoc/antora.yml b/extensions/vw/sse/adoc/antora.yml
index c1675fed61..c05c37e182 100644
--- a/extensions/vw/sse/adoc/antora.yml
+++ b/extensions/vw/sse/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: vw
-version: latest
+version: 2.0.0-RC3
diff --git a/incubator/adoc/antora.yml b/incubator/adoc/antora.yml
index 7df66bfad9..d0099a5463 100644
--- a/incubator/adoc/antora.yml
+++ b/incubator/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: incubator
 title: "Incubator Catalog"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/incubator/extensions/core/commandreplay/adoc/antora.yml b/incubator/extensions/core/commandreplay/adoc/antora.yml
index bc87cdc73c..b98d8ae6e4 100644
--- a/incubator/extensions/core/commandreplay/adoc/antora.yml
+++ b/incubator/extensions/core/commandreplay/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: incubator
-version: latest
+version: 2.0.0-RC3
diff --git a/incubator/viewers/graphql/adoc/antora.yml b/incubator/viewers/graphql/adoc/antora.yml
index bc87cdc73c..b98d8ae6e4 100644
--- a/incubator/viewers/graphql/adoc/antora.yml
+++ b/incubator/viewers/graphql/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: incubator
-version: latest
+version: 2.0.0-RC3
diff --git a/mavendeps/adoc/antora.yml b/mavendeps/adoc/antora.yml
index 072c382aa9..bb04f337c5 100644
--- a/mavendeps/adoc/antora.yml
+++ b/mavendeps/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: docs
-version: latest
+version: 2.0.0-RC3
diff --git a/persistence/jdo/adoc/antora.yml b/persistence/jdo/adoc/antora.yml
index f58f7ffb16..f0a8ab9bb2 100644
--- a/persistence/jdo/adoc/antora.yml
+++ b/persistence/jdo/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: pjdo
 title: "JDO/DataNucleus"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
   - modules/ROOT/nav.adoc
diff --git a/persistence/jpa/adoc/antora.yml b/persistence/jpa/adoc/antora.yml
index 587cd3be21..8e9db54c58 100644
--- a/persistence/jpa/adoc/antora.yml
+++ b/persistence/jpa/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: pjpa
 title: "JPA"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
   - modules/ROOT/nav.adoc
diff --git a/regressiontests/adoc/antora.yml b/regressiontests/adoc/antora.yml
index ad7fd33bfb..e10a36fb47 100644
--- a/regressiontests/adoc/antora.yml
+++ b/regressiontests/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: regressiontests
-version: latest
+version: 2.0.0-RC3
diff --git a/security/adoc/antora.yml b/security/adoc/antora.yml
index c6687a52fb..11d5bb1348 100644
--- a/security/adoc/antora.yml
+++ b/security/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: security
 title: "Security Guide"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/security/bypass/src/main/adoc/antora.yml b/security/bypass/src/main/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/security/bypass/src/main/adoc/antora.yml
+++ b/security/bypass/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/security/keycloak/src/main/adoc/antora.yml b/security/keycloak/src/main/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/security/keycloak/src/main/adoc/antora.yml
+++ b/security/keycloak/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/security/shiro/src/main/adoc/antora.yml b/security/shiro/src/main/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/security/shiro/src/main/adoc/antora.yml
+++ b/security/shiro/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/security/spring/src/main/adoc/antora.yml b/security/spring/src/main/adoc/antora.yml
index 2be11515fd..b7566b916e 100644
--- a/security/spring/src/main/adoc/antora.yml
+++ b/security/spring/src/main/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: security
-version: latest
+version: 2.0.0-RC3
diff --git a/starters/adoc/antora.yml b/starters/adoc/antora.yml
index 072c382aa9..bb04f337c5 100644
--- a/starters/adoc/antora.yml
+++ b/starters/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: docs
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/adoc/antora.yml b/testing/adoc/antora.yml
index e8921cbf0b..c6bae9cc1e 100644
--- a/testing/adoc/antora.yml
+++ b/testing/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: testing
 title: "Testing Guide"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/testing/archtestsupport/adoc/antora.yml b/testing/archtestsupport/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/archtestsupport/adoc/antora.yml
+++ b/testing/archtestsupport/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/fakedata/adoc/antora.yml b/testing/fakedata/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/fakedata/adoc/antora.yml
+++ b/testing/fakedata/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/fixtures/adoc/antora.yml b/testing/fixtures/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/fixtures/adoc/antora.yml
+++ b/testing/fixtures/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/h2console/adoc/antora.yml b/testing/h2console/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/h2console/adoc/antora.yml
+++ b/testing/h2console/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/hsqldbmgr/adoc/antora.yml b/testing/hsqldbmgr/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/hsqldbmgr/adoc/antora.yml
+++ b/testing/hsqldbmgr/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/integtestsupport/adoc/antora.yml b/testing/integtestsupport/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/integtestsupport/adoc/antora.yml
+++ b/testing/integtestsupport/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/specsupport/adoc/antora.yml b/testing/specsupport/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/specsupport/adoc/antora.yml
+++ b/testing/specsupport/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/testing/unittestsupport/adoc/antora.yml b/testing/unittestsupport/adoc/antora.yml
index 3c95843a4b..1804471c9e 100644
--- a/testing/unittestsupport/adoc/antora.yml
+++ b/testing/unittestsupport/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: testing
-version: latest
+version: 2.0.0-RC3
diff --git a/tooling/adoc/antora.yml b/tooling/adoc/antora.yml
index 2bb0e961a3..35e46cf0a6 100644
--- a/tooling/adoc/antora.yml
+++ b/tooling/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: tooling
 title: "Tooling"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/tooling/cli/adoc/antora.yml b/tooling/cli/adoc/antora.yml
index d2f65abf05..c46ee2cf19 100644
--- a/tooling/cli/adoc/antora.yml
+++ b/tooling/cli/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: tooling
-version: latest
+version: 2.0.0-RC3
diff --git a/valuetypes/adoc/antora.yml b/valuetypes/adoc/antora.yml
index 46395c902f..4a0220a922 100644
--- a/valuetypes/adoc/antora.yml
+++ b/valuetypes/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: valuetypes
 title: "Value Types Catalog"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/valuetypes/asciidoc/adoc/antora.yml b/valuetypes/asciidoc/adoc/antora.yml
index 0f50856e63..10085ca3f2 100644
--- a/valuetypes/asciidoc/adoc/antora.yml
+++ b/valuetypes/asciidoc/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: valuetypes
-version: latest
+version: 2.0.0-RC3
diff --git a/valuetypes/jodatime/adoc/antora.yml b/valuetypes/jodatime/adoc/antora.yml
index 0f50856e63..10085ca3f2 100644
--- a/valuetypes/jodatime/adoc/antora.yml
+++ b/valuetypes/jodatime/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: valuetypes
-version: latest
+version: 2.0.0-RC3
diff --git a/valuetypes/markdown/adoc/antora.yml b/valuetypes/markdown/adoc/antora.yml
index 0f50856e63..10085ca3f2 100644
--- a/valuetypes/markdown/adoc/antora.yml
+++ b/valuetypes/markdown/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: valuetypes
-version: latest
+version: 2.0.0-RC3
diff --git a/valuetypes/vega/adoc/antora.yml b/valuetypes/vega/adoc/antora.yml
index 0f50856e63..10085ca3f2 100644
--- a/valuetypes/vega/adoc/antora.yml
+++ b/valuetypes/vega/adoc/antora.yml
@@ -16,4 +16,4 @@
 #  under the License.
 
 name: valuetypes
-version: latest
+version: 2.0.0-RC3
diff --git a/viewers/restfulobjects/adoc/antora.yml b/viewers/restfulobjects/adoc/antora.yml
index 951ffc02c2..212d87e804 100644
--- a/viewers/restfulobjects/adoc/antora.yml
+++ b/viewers/restfulobjects/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: vro
 title: "REST API (Restful Objects Viewer)"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc
diff --git a/viewers/wicket/adoc/antora.yml b/viewers/wicket/adoc/antora.yml
index 960d7e73bb..41fb99348d 100644
--- a/viewers/wicket/adoc/antora.yml
+++ b/viewers/wicket/adoc/antora.yml
@@ -17,7 +17,7 @@
 
 name: vw
 title: "Web UI (Wicket Viewer)"
-version: latest
+version: 2.0.0-RC3
 start_page: ROOT:about.adoc
 nav:
 - modules/ROOT/nav.adoc


[causeway] 07/08: CAUSEWAY-3528: improves release docs

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit c5d181a034498c2c32dda6969c94069e9f4a5abf
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 9 23:01:40 2023 +0100

    CAUSEWAY-3528: improves release docs
---
 .../ROOT/pages/post-release-successful.adoc        | 156 +++++++++++++--------
 1 file changed, 97 insertions(+), 59 deletions(-)

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 cd27232e20..c11ac731a4 100644
--- a/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
+++ b/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
@@ -293,129 +293,167 @@ We are now ready to xref:#generate-website[generate the website].
 [#generate-website]
 == Generate website
 
-We use Antora to generate the site, not only the version being release but also any previous versions listed in `site.yml`; each of these are tags.
-The most recent version is also tagged with the `latest` branch (updated each release); this means that neither the `antora.yml` files nor top-level `index.html` file needs to be updated.
-The `antora/playbooks/site.yml` _does_ need to be updated, but the `site-ALL.yml` file (alongside it) is used as a way to quickly make the necessary edits.
+We use Antora to generate the site, not only the version being released but also any previous versions listed in `site.yml`; each of these are tags.
+This is done using the `content.sources.url[].branches` properties.
+We use branches for all cases - note that the branch name appears in the generated UI.
+If there are patches to the documentation, we move the branches.
+
+We therefore temporarily modify all of the `antora.yml` files (and update `index.html`) file and create a branch for this change; then we update `site.yml` with a reference to that new branch.
+All of this is changed afterwards.
+
+We also use the link:https://docs.antora.org/antora/latest/playbook/urls-latest-version-segment/[latest version] support of Antora 3.x so that the most recent version is made available as "latest".
+This has two benefits: first, the top-level `index.html` (in `supplemental-ui`) does not need to be updated, and secondly, this improves search engine results as there will always be a `latest` version.
 
 
 [#create-doc-branch]
 === Create doc branch
 
-Update `site.yml` using `site.NEXT.yml`:
+First, we update all versions in `antora.yml`:
 
-* move `site.yml` to one side, and replace with `site.NEXT.yml`:
+* Update all `antora.yml` files:
 +
 [source,bash,subs="attributes+"]
 ----
-mv site.yml      site.ORIG.yml
-mv site.NEXT.yml site.yml
+find . -name antora.yml -exec sed -i 's/latest/{page-causewayrel}/g' {} \;
+----
+
+* Commit all these changes:
++
+[source,bash,subs="attributes+"]
+----
+git add .
+git commit -m "$CAUSEWAYJIRA: bumps antora.yml versions to $CAUSEWAYREL"
 ----
 
-* update the new `site.yml`:
+We now create a branch to reference in the `site.yml`, later on.
 
-** for each documentation component, add in a reference to a new branch `{page-causewayrel}` (we'll create it in the next step).
-Also make sure that the `latest` tag is also in the list; eg:
+* We create the `{page-causewayrel}` branch.
 +
-[source,yaml,subs="attributes+"]
-.site.yml
+This mirrors the "rel/causeway-{page-causewayrel}" used for the formal (immutable) release tag, but is a branch because it allows us to move it, and must have this simplified name as it is used in the "edit page" link of the site template.
++
+[source,bash,subs="attributes+"]
 ----
-content:
-  sources:
-    - url: .
-      start_path: antora/components/docs # docs
-      branches: [2.0.0-M5, ...  2.0.0-RC3, latest]
-      # ...
-    - url: .
-      start_path: viewers/wicket/adoc # vw
-      branches: [2.0.0-M5, ... 2.0.0-RC3, latest]
+git branch {page-causewayrel}
+git push origin {page-causewayrel}
 ----
 
-* also check that the attributes are correct.
+Now we make sure that the docs in the new doc branch are actually up-to-date.
+(There is no need to update `site.yml`, because at this stage it continues to refer to the `HEAD` branch):
+
+* checkout the branch:
 +
-The value of the `page-causewayprev` attribute needs to be (the current) `{page-causewayrel}`, and `page-causewayrel` then set to the next likely release version:
+[source,bash,subs="attributes+"]
+----
+git checkout {page-causewayrel}
+----
+
+* build prereqs
 +
-[source,yaml,subs="attributes+"]
-.site.yml
+[source,bash,subs="attributes+"]
 ----
-asciidoc:
-  attributes:
-    page-causewayprev: "..."
-    page-causewayrel: "..."
+pushd bom
+mvnd clean install -T1C -DskipTests -Dgithub
+popd
+mvnd -D module-tooling -D skip.essential install -DskipTests
 ----
 
-* commit the changes
+* generate the website:
++
+[source,bash,subs="attributes+"]
+----
+sh preview.sh
+----
+
+* if any files have changed, then commit:
 +
 [source,bash,subs="attributes+"]
 ----
 git add .
-git commit -m "$CAUSEWAYJIRA: updates site.yml in readiness for website generation"
+git commit -m "$CAUSEWAYJIRA: updates docs on new release branch"
 ----
 
-Now we ensure that the `{page-causewayrel}` branch and the `latest` tag refer to the current location:
 
-* create the `{page-causewayrel}` branch.
-+
-This mirrors the "rel/causeway-{page-causewayrel}" used for the formal (immutable) release tag.
+* push the updated doc branch:
 +
 [source,bash,subs="attributes+"]
 ----
-git branch {page-causewayrel}
 git push origin {page-causewayrel}
 ----
 
-* update the `latest` branch.
-This name is used in the "edit page" link of the site template.
-+
+
+
+Revert the last commit (backing out changes to `antora.yml` files):
+
 [source,bash,subs="attributes+"]
 ----
-git branch -f latest HEAD
-git push origin latest -f
+git revert HEAD
 ----
 
 
+[#update-site-yml]
+=== Update the site
 
-=== Update the doc branch
+To build the site (referencing the current release and all previous releases), we need to update the `site.yml`.
 
-Now we make sure that the docs in the new doc branch are actually up-to-date:
+This is done in the release branch (`$CAUSEWAYBRANCH`), _not_ in the documentation branch for the current release ({page-causewayrel}).
+In other words:
 
-* checkout the branch:
-+
 [source,bash,subs="attributes+"]
 ----
-git checkout latest
+git checkout $CAUSEWAYBRANCH            #<.>
+git merge {page-causewayrel} --ff-only  #<.>
 ----
+<.> will be before the documentation branch of the current release
+<.> move forward to incorporate any changes made thus far on the documentation branch
 
-* build prereqs
+Now, update `site.yml` using `site.NEXT.yml`:
+
+* move `site.yml` to one side, and replace with `site.NEXT.yml`:
 +
 [source,bash,subs="attributes+"]
 ----
-pushd bom
-mvnd clean install -T1C -DskipTests -Dgithub
-popd
-mvnd -D module-tooling -D skip.essential install -DskipTests
+mv site.yml      site.ORIG.yml
+mv site.NEXT.yml site.yml
 ----
 
-* generate the website:
+* update the new `site.yml`, eg:
 +
-[source,bash,subs="attributes+"]
+[source,yaml,subs="attributes+"]
+.site.yml
 ----
-sh preview.sh
+content:
+  sources:
+    - url: .
+      start_path: antora/components/docs # docs
+      branches: [2.0.0-M5, ...  2.0.0-RC3]
+      # ...
+    - url: .
+      start_path: viewers/wicket/adoc # vw
+      branches: [2.0.0-M5, ... 2.0.0-RC3]
 ----
 
-* push the updated doc branch:
+* check that the attributes are correct.
 +
-[source,bash,subs="attributes+"]
+[source,yaml,subs="attributes+"]
+.site.yml
 ----
-git push origin {page-causewayrel}
+asciidoc:
+  attributes:
+    page-causewayprev: "..."    #<.>
+    page-causewayrel: "..."     #<.>
 ----
+<.> needs to be (the current) `{page-causewayrel}`
+<.> needs to be set to the _next_ likely release version.
 
-* finally switch back to the release branch:
+* commit the changes
 +
 [source,bash,subs="attributes+"]
 ----
-git checkout $CAUSEWAYBRANCH
+git add .
+git commit -m "$CAUSEWAYJIRA: updates site.yml in readiness for website generation"
 ----
 
+
 === Generate the site
 
 We are now in a position to actually generate the Antora website.


[causeway] 04/08: CAUSEWAY-3528: updates release notes, STATUS and doap_causeway.rdf

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit f912ffde957eb9d0233b203c9dd9d77a074b1db6
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 9 19:04:31 2023 +0100

    CAUSEWAY-3528: updates release notes, STATUS and doap_causeway.rdf
---
 STATUS                                                   | 2 ++
 antora/components/relnotes/modules/ROOT/pages/about.adoc | 2 +-
 antora/supplemental-ui/doap_causeway.rdf                 | 2 +-
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/STATUS b/STATUS
index 09f9aea145..c657b0a3f4 100644
--- a/STATUS
+++ b/STATUS
@@ -24,6 +24,8 @@ Description
 
 TLP releases:
 
+  * causeway-2.0.0-RC3                             :  9 Oct 2023
+
   * causeway-2.0.0-RC2                             : 13 Jul 2023
 
   * causeway-2.0.0-RC1                             : 25 Mar 2023
diff --git a/antora/components/relnotes/modules/ROOT/pages/about.adoc b/antora/components/relnotes/modules/ROOT/pages/about.adoc
index 70cafffe5e..d436e6c319 100644
--- a/antora/components/relnotes/modules/ROOT/pages/about.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/about.adoc
@@ -27,7 +27,7 @@ This table summarises all releases of Apache Causeway v2.0 to date.
 * xref:relnotes:ROOT:2024/2.0.0-RC4/mignotes.adoc[Migration Notes]
 
 | 2.0.0-RC3
-| 6th Oct 2023
+| 9th Oct 2023
 | Third release candidate for Apache Causeway 2.0.0.
 | 19
 | 40
diff --git a/antora/supplemental-ui/doap_causeway.rdf b/antora/supplemental-ui/doap_causeway.rdf
index e07364c80f..9ba9673cde 100644
--- a/antora/supplemental-ui/doap_causeway.rdf
+++ b/antora/supplemental-ui/doap_causeway.rdf
@@ -39,7 +39,7 @@
     <release>
       <Version>
         <name>causeway</name>
-        <created>2023-10-06</created>
+        <created>2023-10-09</created>
         <revision>2.0.0-RC3</revision>
       </Version>
     </release>


[causeway] 03/08: : updates release notes, STATUS and doap_causeway.rdf

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit 853e463385addd8ab9a42657e924d791637e19ba
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 2 22:32:15 2023 +0100

    : updates release notes, STATUS and doap_causeway.rdf
---
 .../modules/ROOT/pages/cutting-a-release.adoc      | 109 +++++++----------
 antora/components/relnotes/modules/ROOT/nav.adoc   |   1 +
 .../ROOT/pages/2023/2.0.0-RC2/mignotes.adoc        |   1 -
 .../ROOT/pages/2023/2.0.0-RC3/relnotes.adoc        | 132 ++++++++++++++++++++-
 .../relnotes.adoc => 2024/2.0.0-RC4/mignotes.adoc} |   6 +-
 .../2.0.0-RC3 => 2024/2.0.0-RC4}/relnotes.adoc     |   8 +-
 .../relnotes/modules/ROOT/pages/about.adoc         |  14 ++-
 antora/supplemental-ui/doap_causeway.rdf           |   8 ++
 8 files changed, 200 insertions(+), 79 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 5a001d533c..0917ed7ebf 100644
--- a/antora/components/comguide/modules/ROOT/pages/cutting-a-release.adoc
+++ b/antora/components/comguide/modules/ROOT/pages/cutting-a-release.adoc
@@ -70,8 +70,8 @@ To run the RAT tool, use:
 .find unapproved/missing licenses
 ----
 pushd bom
-mvn -Dapache-release clean
-mvn -Dapache-release org.apache.rat:apache-rat-plugin:check -D rat.numUnapprovedLicenses=1000     # <.>
+mvnd -Dapache-release clean
+mvnd -Dapache-release org.apache.rat:apache-rat-plugin:check -D rat.numUnapprovedLicenses=1000     # <.>
 popd
 
 for a in `/bin/find . -name rat.txt -print`; do grep '!???' $a; done > /tmp/rat-qn.txt            # <.>
@@ -106,8 +106,8 @@ This is stored in the `src/main/appended-resources/supplemental-models.xml` file
 [source,bash,subs="attributes+"]
 ----
 pushd bom
-mvn -Dgithub clean install -T1C -DskipTests # <.>
-mvn -Dgithub license:download-licenses      # <.>
+mvnd -Dgithub clean install -T1C -DskipTests # <.>
+mvnd -Dgithub license:download-licenses      # <.>
 popd
 groovy scripts/checkmissinglicenses.groovy  # <.>
 ----
@@ -161,7 +161,7 @@ The next step is to generate the website, ensuring that the config, examples, pr
 +
 [source,bash,subs="attributes+"]
 ----
-mvn -D module-tooling -D skip.essential install -DskipTests -T1C
+mvnd -D module-tooling -D skip.essential install -DskipTests -T1C
 ----
 
 * Then, generate the website:
@@ -171,7 +171,7 @@ mvn -D module-tooling -D skip.essential install -DskipTests -T1C
 sh preview.sh
 ----
 +
-NOTE: this now runs `mvn clean install -pl core/config` automatically.
+NOTE: this now runs `mvnd clean install -pl core/config` automatically.
 
 Check for any Asciidoc errors, and fix.
 Also double-check that the config property files are correctly formatted.
@@ -220,32 +220,22 @@ git commit -m "$CAUSEWAYJIRA: updates to pom.xml etc for release"
 
 
 
-=== Create a release branch and worktree
+=== Create a release branch
 
 The release is performed on a branch; if we are successful, this branch will be merged back into master.
+We also recommend creating a separate git worktree to capture any documentation fixes that you might notice along the way.
 
-We also recommend performing this work in a separate git worktree.
-The original worktree can stay with the `master` branch and be used for documentation fixes, etc.
-
-* create (but don't checkout) a release branch for the version number being released; eg:
+* create and checkout a release branch for the version number being released; eg:
 +
 [source,bash,subs="attributes+"]
 ----
-git branch $CAUSEWAYBRANCH
+git branch -b $CAUSEWAYBRANCH
 ----
 
-* Create a worktree for this branch:
+* Push the branch:
 +
 [source,bash,subs="attributes+"]
 ----
-git worktree add ../causeway-release $CAUSEWAYBRANCH
-----
-
-* Switch to the new worktree and push the branch:
-+
-[source,bash,subs="attributes+"]
-----
-cd ../causeway-release
 git push origin $CAUSEWAYBRANCH -u
 ----
 
@@ -262,7 +252,7 @@ cd bom
 
 === Bump projects to `$CAUSEWAYREL`
 
-We use `mvn versions:set` to manually bump the release version.
+We use `mvnd versions:set` to manually bump the release version.
 (After release, there is a xref:comguide:ROOT:cutting-a-release.adoc#reset-revision-property[similar step at the end] to reset back to a `-SNAPSHOT` version).
 
 (Still in the `bom` directory), the steps are:
@@ -271,14 +261,14 @@ We use `mvn versions:set` to manually bump the release version.
 +
 [source,bash,subs="attributes+"]
 ----
-mvn versions:set -DnewVersion=$CAUSEWAYREL
+mvnd versions:set -DnewVersion=$CAUSEWAYREL
 ----
 
 * next we build the framework so that these versioned `pom.xml` files are available for the next step:
 +
 [source,bash,subs="attributes+"]
 ----
-mvn install -o -DskipTests -T1C -Dgithub
+mvnd install -o -DskipTests -T1C -Dgithub
 ----
 +
 The `-Dgithub` property activates the "github" profile that references all modules to be released.
@@ -288,8 +278,8 @@ The `-Dgithub` property activates the "github" profile that references all modul
 [source,bash,subs="attributes+"]
 ----
 pushd ../starters
-mvn versions:set -DnewVersion=$CAUSEWAYREL
-mvn install -DskipTests -o
+mvnd versions:set -DnewVersion=$CAUSEWAYREL
+mvnd install -DskipTests -o
 popd
 ----
 
@@ -313,14 +303,14 @@ Still in the `bom` directory:
 [source,bash,subs="attributes+"]
 ----
 rm -rf ~/.m2/repository/org/apache/causeway
-mvn clean install -o -T1C -Dgithub
+mvnd clean install -o -T1C -Dgithub
 git clean -dfx ..
 ----
 
 
 === Deploy
 
-Since the `<version>` has already been updated, we just use `mvn deploy` to upload the artifacts.
+Since the `<version>` has already been updated, we just use `mvnd deploy` to upload the artifacts.
 We activate the (inherited) `apache-release` profile to bring in the `gpg` plugin for code signing.
 
 ==== Prerequisites
@@ -513,12 +503,12 @@ Therefore, still in the `bom` directory:
 
 [source,bash,subs="attributes+"]
 ----
-mvn versions:set -DnewVersion=2.0.0-SNAPSHOT
-mvn install -DskipTests -o -T1C -Dgithub
+mvnd versions:set -DnewVersion=2.0.0-SNAPSHOT
+mvnd install -DskipTests -o -T1C -Dgithub
 
 pushd ../starters
-mvn versions:set -DnewVersion=2.0.0-SNAPSHOT
-mvn install -DskipTests -o
+mvnd versions:set -DnewVersion=2.0.0-SNAPSHOT
+mvnd install -DskipTests -o
 popd
 
 git add ..
@@ -580,8 +570,8 @@ git pull --ff-only
 
 git checkout -b $CAUSEWAYBRANCH-jpa
 
-mvn versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly # <.>
-mvn versions:set -DnewVersion=$CAUSEWAYREL
+mvnd versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly # <.>
+mvnd versions:set -DnewVersion=$CAUSEWAYREL
 
 git add .
 git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jpa)"
@@ -593,8 +583,8 @@ git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jpa)"
 +
 [source,bash,subs="attributes+"]
 ----
-mvn clean install
-mvn spring-boot:run
+mvnd clean install
+mvnd spring-boot:run
 ----
 
 ** Make any additional changes that might be required (eg update to `menubars.layout.xml`) commit and retest
@@ -617,8 +607,8 @@ git pull --ff-only
 
 git checkout -b $CAUSEWAYBRANCH-jdo
 
-mvn versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly
-mvn versions:set -DnewVersion=$CAUSEWAYREL
+mvnd versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly
+mvnd versions:set -DnewVersion=$CAUSEWAYREL
 
 git add .
 git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jdo)"
@@ -628,8 +618,8 @@ git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jdo)"
 +
 [source,bash,subs="attributes+"]
 ----
-mvn clean install
-mvn spring-boot:run
+mvnd clean install
+mvnd spring-boot:run
 ----
 
 ** Make any additional changes that might be required, and re-test.
@@ -673,8 +663,8 @@ git pull --ff-only
 
 git checkout -b $CAUSEWAYBRANCH-jpa
 
-mvn versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly  # <.>
-mvn versions:set -DnewVersion=$CAUSEWAYREL
+mvnd versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly  # <.>
+mvnd versions:set -DnewVersion=$CAUSEWAYREL
 
 git add .
 git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jpa)"
@@ -685,8 +675,8 @@ git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jpa)"
 +
 [source,bash,subs="attributes+"]
 ----
-mvn clean install
-mvn -pl webapp spring-boot:run
+mvnd clean install
+mvnd -pl webapp spring-boot:run
 ----
 
 ** Make any additional changes that might be required (eg update to `menubars.layout.xml`) commit and retest
@@ -710,8 +700,8 @@ git pull --ff-only
 
 git checkout -b $CAUSEWAYBRANCH-jdo
 
-mvn versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly
-mvn versions:set -DnewVersion=$CAUSEWAYREL
+mvnd versions:update-parent -DparentVersion=$CAUSEWAYREL -Dskip.nightly
+mvnd versions:set -DnewVersion=$CAUSEWAYREL
 
 git add .
 git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jdo)"
@@ -721,8 +711,8 @@ git commit -m "$CAUSEWAYJIRA - updates to $CAUSEWAYREL (jdo)"
 +
 [source,bash,subs="attributes+"]
 ----
-mvn clean install
-mvn -pl webapp spring-boot:run
+mvnd clean install
+mvnd -pl webapp spring-boot:run
 ----
 
 ** Make any additional changes that might be required, and re-test.
@@ -787,33 +777,14 @@ done
 popd
 ----
 
-* Back in the `causeway` repo's `release` worktree, generate the Antora site (from the top-level directory).
+* Back in the `causeway` repo, generate the Antora site (from the top-level directory).
 +
 [source,bash,subs="attributes+"]
 ----
-cd ../causeway-release
+cd ../causeway
 
 sh preview.sh -AB
 ----
-+
-[WARNING]
-====
-This procedure doesn't yet work; Antora does not yet support worktrees.
-
-So instead it's currently necessary to perform the preview in the main `../causeway` directory, switching branches.
-You'll also need to rebuild all and then regenerate config files and tooling:
-
-[source,bash,subs="attributes+"]
-----
-git checkout $CAUSEWAYBRANCH
-pushd bom
-mvn clean install -DskipTests -T1C -Dgithub
-popd
-mvn -D module-tooling -D skip.essential install -DskipTests
-----
-
-====
-
 
 * Copy the generated Antora site to `causeway-site` repo's `contents` directory:
 +
diff --git a/antora/components/relnotes/modules/ROOT/nav.adoc b/antora/components/relnotes/modules/ROOT/nav.adoc
index 0577bc05f9..4cba232659 100644
--- a/antora/components/relnotes/modules/ROOT/nav.adoc
+++ b/antora/components/relnotes/modules/ROOT/nav.adoc
@@ -3,6 +3,7 @@
 
 
 * 2023
+** xref:relnotes:ROOT:2023/2.0.0-RC3/relnotes.adoc[2.0.0-RC3]
 ** xref:relnotes:ROOT:2023/2.0.0-RC2/relnotes.adoc[2.0.0-RC2]
 ** xref:relnotes:ROOT:2023/2.0.0-RC1/relnotes.adoc[2.0.0-RC1]
 * 2022
diff --git a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC2/mignotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC2/mignotes.adoc
index 8cc0fbf9de..727281020a 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC2/mignotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC2/mignotes.adoc
@@ -3,7 +3,6 @@
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 :page-partial:
 
-This page will be added to as development progresses.
 
 == Programming Model
 
diff --git a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc
index e9600fc7d3..2d6e03707d 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc
@@ -4,4 +4,134 @@
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 :page-partial:
 
-Not available yet. To be announced.
\ No newline at end of file
+
+This release is primarily a stabilization and bug fix release, but there are a small number of new features, mostly improving the Wicket UI.
+There are also some new support classes for Oauth2 (using Spring security), as well as improved support for background commands.
+
+
+
+== New Feature
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3619[CAUSEWAY-3619] - SPI for the `GridSystemServiceBootstrap` to provide custom layouts.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3616[CAUSEWAY-3616] - Allow background command job to be paused
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3614[CAUSEWAY-3614] - Allow default min scale to be optionally defined for `BigDecimalValueSemantics`.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3607[CAUSEWAY-3607] - `ParamDto` id's in commands and executions should use "internalId" rather than "Friendly Name"
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3599[CAUSEWAY-3599] - Extend `TableColumnOrderService` so that parented collections also fallback to use `Xxx.columnOrder.txt`
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3598[CAUSEWAY-3598] - Allow logical type name to optionally be one of a class's aliases.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3597[CAUSEWAY-3597] - Mixins to download `.columnOrder.txt` files
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3595[CAUSEWAY-3595] - Date picker should optionally automatically popup when focus
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3592[CAUSEWAY-3592] - Allow `@Column#scale` and `@Digits#fraction` to derive the min fractional digits (as well as the max)
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3574[CAUSEWAY-3574] - Wicket date picker display format.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3571[CAUSEWAY-3571] - Support for generic type bounded methods that are not overwritten using explicit types.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3566[CAUSEWAY-3566] - [Wicket Viewer] Allow HTML in Tooltips, if enabled via Config.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3557[CAUSEWAY-3557] - `FakeScheduler` for integ tests.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3556[CAUSEWAY-3556] - [Metamodel] Support for action methods that override generic type bounded ones
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3547[CAUSEWAY-3547] - [SecMan] Support for Seeding from YAML file.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3545[CAUSEWAY-3545] - Better support for Oauth2 (including JWT classes); add retry logic to `RestfulClient`, make more configurable
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3524[CAUSEWAY-3524] - Allow secman permission evaluator to support v1 strategy (package names rather than logical type names)
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3521[CAUSEWAY-3521] - Allow `TableColumnOrderService` to also read from a `.columnOrder.fallback.txt` file.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3517[CAUSEWAY-3517] - Secman should ALWAYS allow logout action (as a special case).
+
+
+== Improvement
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3618[CAUSEWAY-3618] - Secman should copy the user's roles into the `UserMemento` (as obtained via `UserService`).
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3613[CAUSEWAY-3613] - package for exceldownload inconsistent with other wicket viewer extensions
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3608[CAUSEWAY-3608] - Improve `ConfigurationViewModel` to show all properties, not just those for selected config roots..
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3605[CAUSEWAY-3605] - `_Exceptions` utility method should never itself throw an exception when attempting to format its error message.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3602[CAUSEWAY-3602] - Run background commands job with one interaction/transaction per command.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3601[CAUSEWAY-3601] - [Extensions] Autosize Columns for Excel Exports/Downloads
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3596[CAUSEWAY-3596] - Don't allow tabbing to the 'T' or ban buttons.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3594[CAUSEWAY-3594] - [Wicket Viewer] Time-Taken message (when prototyping) is nowhere near actual response time
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3593[CAUSEWAY-3593] - Validators missing for JPA handling of `@Column`.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3591[CAUSEWAY-3591] - jpa integration classes misplaced?
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3590[CAUSEWAY-3590] - [Wicket Viewer] cosmetic: less confusing selected collection presentation indicator in dropdown
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3589[CAUSEWAY-3589] - All framework defined mixins should declare their command and execution publishing.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3587[CAUSEWAY-3587] - [cosmetic] fa icons and bootstrap colours - extend and clean up default config.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3586[CAUSEWAY-3586] - Allow for `ViewModel.viewModelMemento()` to return non-url-safe Strings
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3585[CAUSEWAY-3585] - [Metamodel] Allow for Types that subclass an Entity Type to actually be a `Viewmodel`.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3582[CAUSEWAY-3582] - [Wicket Viewer] cosmetic: menu items in dropdowns misaligned, if some don't have fa-icon
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3580[CAUSEWAY-3580] - [cosmetic] checkbox label misaligned, too high
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3578[CAUSEWAY-3578] - [Wicket Viewer] Honor @CollectionLayout(hidden=...) when not hidden in Tables
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3575[CAUSEWAY-3575] - [Layout] Allow for slot-in order of unreferenced associations to be configured either sequence-based or alphabetical.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3573[CAUSEWAY-3573] - Not possible to copy a URL link from the icon (this could be done in v1).
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3570[CAUSEWAY-3570] - positioning of the "T" hint varies by scalar type.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3565[CAUSEWAY-3565] - [DocGen] Make ObjectGraph a first Class Citizen to allow for easy Customizations.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3564[CAUSEWAY-3564] - [Valuetypes/Tooling] Replace causeway-tooling-model4adoc with causeway-valuetypes-asciidoc-builder
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3563[CAUSEWAY-3563] - [SecMan] Autoseed Regular User Perms for ExtDocgen when Module is present
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3554[CAUSEWAY-3554] - Framework should throw a more meaningful exception, when `validateXxx` support method returns an empty string.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3553[CAUSEWAY-3553] - Make `JaxbServiceDefault` use backward compatible XML serialization
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3552[CAUSEWAY-3552] - Allow setting of properties on a transient entity (eg when import Excel spreadsheet).
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3551[CAUSEWAY-3551] - [Wicket Viewer] Cosmetic: disabled buttons appear smaller
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3550[CAUSEWAY-3550] - `YamlUtils`: Global tag expression is discouraged
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3543[CAUSEWAY-3543] - `AuthenticatedWebSessionForCauseway` lookup MetaModelContext rather than injected.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3536[CAUSEWAY-3536] - [Wicket Viewer] Cosmetic: if Table has no Column at least render Titles
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3534[CAUSEWAY-3534] - [Wicket Viewer] Cosmetic: Button Label w/o Icon is not centered
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3533[CAUSEWAY-3533] - Remove code marked as deprecated for removal since RC2
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3510[CAUSEWAY-3510] - Ugly warning message on login page if clear cookies.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3500[CAUSEWAY-3500] - [Persistence] Cleanup ambiguous EntityState Terminology
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3481[CAUSEWAY-3481] - [invalid] Remove `sequence` attribute from `.layout.xml` - it doesn't really accomplish much.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3432[CAUSEWAY-3432] - [Wicket Viewer] Focus for `@ActionLayout#promptStyle` of inline or inline-as-if-edit is not on the field.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3430[CAUSEWAY-3430] - Remove `<action namedEscaped=...>` attribute from `layout.xml`
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3048[CAUSEWAY-3048] - Suggested UI improvements (after review demo app)
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3035[CAUSEWAY-3035] - Log Stacktrace alongside ERROR to Console
+
+
+== Bug
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3615[CAUSEWAY-3615] - Swagger UI authorize button doesn't seem to work.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3617[CAUSEWAY-3617] - `isis.applib.annotation.action.command-publishing` is set to 'ignore_safe', and yet these are being logged.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3611[CAUSEWAY-3611] - Restful Objects viewer domain-types uses paramName instead of paramId
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3610[CAUSEWAY-3610] - `AuditTrailEntry` instances not correlated back to command if executed via `CommandExecutorService` (ie background commands)
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3609[CAUSEWAY-3609] - `EntityPropertyChangePublisherDefault` fails to add audit records if hits hollowed object.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3606[CAUSEWAY-3606] - `DnStateManagerForHollow` calls `_Exceptions.unrecoverable` with side effects
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3604[CAUSEWAY-3604] - Can't view background command that has siblings.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3603[CAUSEWAY-3603] - [Commons] Lazy type does not handle evaluation exceptions well.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3588[CAUSEWAY-3588] - actions annotated with command or execution publishing disabled are nevertheless being published.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3583[CAUSEWAY-3583] - [cosmetic] properties hidden when `REFERENCES_PARENT` aren't being hidden.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3577[CAUSEWAY-3577] - `Object_identifier` is picked up as an action rather than a property.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3576[CAUSEWAY-3576] - ``Calendarable``'s method should be marked as `@Programmatic`.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3572[CAUSEWAY-3572] - for narrow screens, the secondary menu does not wrap while the primary does.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3562[CAUSEWAY-3562] - [Wicket Viewer] rendering an empty 'home-page' will throw
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3561[CAUSEWAY-3561] - [Wicket Viewer] rendering an empty tree will throw class-cast exception
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3560[CAUSEWAY-3560] - [Wicket Viewer] Cosmetic: Header panels prim vs sec/tert have different text color
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3559[CAUSEWAY-3559] - [Wicket Viewer] `AuthenticatedWebSessionForCauseway` fails to log when session exipres
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3555[CAUSEWAY-3555] - Fix serialization of null args via `BackgroundService`, to `CommandDto` and back out for executoin.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3549[CAUSEWAY-3549] - `ImpersonateMenuAdvisorForSecman.allUserNames` should comply with contract
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3546[CAUSEWAY-3546] - In testing, saw `OutboxRestApi#pending` action itself in the outbox, suggests `executionPublishing=DISABLED` isn't being honoured?
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3538[CAUSEWAY-3538] - [Regression] Wicket Viewer: Non-serializable object causes errors when list all, and elsewhere.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3532[CAUSEWAY-3532] - [Regression] Loading an `EntityPage` when Object-Not-Found results in HTTP 500 (JDO+JPA)
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3531[CAUSEWAY-3531] - [Metamodel] Corner Case: Mixedin Action picked up as Association
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3530[CAUSEWAY-3530] - Managed Object for Entity: On object refetch, Object-Not-Found should be silently ignored
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3525[CAUSEWAY-3525] - [SecMan] 'Name Formatted' shows up in the UI, should be programmatic
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3522[CAUSEWAY-3522] - [Wicket Viewer] Potential Issues when Expanding Tree Nodes
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3479[CAUSEWAY-3479] - [Wicket Viewer] spacing of error when edit a property directly.
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3015[CAUSEWAY-3015] - [Wicket Viewer] Property Edit via `FormExecutorDefault`, will not display Recoverable Exception
+
+
+
+== Task
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3528[CAUSEWAY-3528] - Release activities for 2.0.0-RC3
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3156[CAUSEWAY-3156] - Change name in Board Report Schedule
+
+
+== Previously Implemented
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-1031[CAUSEWAY-1031] - [Wish] Make it possible to filter on tables
+
+
+== Duplicates
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3581[CAUSEWAY-3581] - [duplicate] cosmetic - numbers not showing right aligned in tables; losing .00 for bigdecimals
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3558[CAUSEWAY-3558] - [DUPLICATE] `CommandExecutorService` should handle 'take over' and handle publishing phase of its calling thread.
+
+
+== Not a problem / Invalid / Can't Reproduce
+
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3600[CAUSEWAY-3600] - [INVALID] Contributed properties and collections should not be published as executions
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3568[CAUSEWAY-3568] - [NOT A PROBLEM] Incorrectly requiring supporting choices/autoComplete for actions with list params
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3539[CAUSEWAY-3539] - [CAN'T REPRODUCE] Inspect metamodel is rendered incorrectly
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3520[CAUSEWAY-3520] - Framework fails to build with Eclipse M2E 2.4.0.20230704-1545
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3389[CAUSEWAY-3389] - {not a problem] Impersonate menu is missing from simpleapp, though not helloworld ? Also metamodel actions?
+* link:https://issues.apache.org/jira/browse/CAUSEWAY-3079[CAUSEWAY-3079] - [not a problem] Secman should provide a convenience role to allow fixture scripts to be run.
diff --git a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0-RC4/mignotes.adoc
similarity index 90%
copy from antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc
copy to antora/components/relnotes/modules/ROOT/pages/2024/2.0.0-RC4/mignotes.adoc
index e9600fc7d3..dbf29e07c9 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0-RC4/mignotes.adoc
@@ -1,7 +1,7 @@
-[[r2.0.0-RC3]]
-= 2.0.0-RC3
+= Migrating from RC3 to RC4
 
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 :page-partial:
 
-Not available yet. To be announced.
\ No newline at end of file
+This page will be added to as development progresses.
+
diff --git a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0-RC4/relnotes.adoc
similarity index 92%
copy from antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc
copy to antora/components/relnotes/modules/ROOT/pages/2024/2.0.0-RC4/relnotes.adoc
index e9600fc7d3..a6e82ea6e9 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2023/2.0.0-RC3/relnotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2024/2.0.0-RC4/relnotes.adoc
@@ -1,7 +1,9 @@
-[[r2.0.0-RC3]]
-= 2.0.0-RC3
+[[r2.0.0-RC4]]
+= 2.0.0-RC4
 
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 :page-partial:
 
-Not available yet. To be announced.
\ No newline at end of file
+
+Not available yet.
+
diff --git a/antora/components/relnotes/modules/ROOT/pages/about.adoc b/antora/components/relnotes/modules/ROOT/pages/about.adoc
index 139e92306c..70cafffe5e 100644
--- a/antora/components/relnotes/modules/ROOT/pages/about.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/about.adoc
@@ -16,13 +16,23 @@ This table summarises all releases of Apache Causeway v2.0 to date.
 | Bugs
 | Detail
 
-| 2.0.0-RC3
+| 2.0.0-RC4
 | _tba_
-| Third release candidate for Apache Causeway 2.0.0.
+| Fourth release candidate for Apache Causeway 2.0.0.
 | _tba_
 | _tba_
 | _tba_
 |
+* xref:relnotes:ROOT:2024/2.0.0-RC4/relnotes.adoc[Release Notes]
+* xref:relnotes:ROOT:2024/2.0.0-RC4/mignotes.adoc[Migration Notes]
+
+| 2.0.0-RC3
+| 6th Oct 2023
+| Third release candidate for Apache Causeway 2.0.0.
+| 19
+| 40
+| 28
+|
 * xref:relnotes:ROOT:2023/2.0.0-RC3/relnotes.adoc[Release Notes]
 * xref:relnotes:ROOT:2023/2.0.0-RC3/mignotes.adoc[Migration Notes]
 
diff --git a/antora/supplemental-ui/doap_causeway.rdf b/antora/supplemental-ui/doap_causeway.rdf
index cc4001b6ae..e07364c80f 100644
--- a/antora/supplemental-ui/doap_causeway.rdf
+++ b/antora/supplemental-ui/doap_causeway.rdf
@@ -36,6 +36,14 @@
     <category rdf:resource="http://projects.apache.org/category/web-framework" />
 
 
+    <release>
+      <Version>
+        <name>causeway</name>
+        <created>2023-10-06</created>
+        <revision>2.0.0-RC3</revision>
+      </Version>
+    </release>
+
     <release>
       <Version>
         <name>causeway</name>


[causeway] 06/08: CAUSEWAY-3528: improves release docs

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit e0140b654ca64899f11975627cfbf4918acb5e7a
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 9 22:11:21 2023 +0100

    CAUSEWAY-3528: improves release docs
---
 .../ROOT/pages/post-release-successful.adoc        | 125 ++++++++++++---------
 1 file changed, 71 insertions(+), 54 deletions(-)

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 3d48af9a78..cd27232e20 100644
--- a/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
+++ b/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
@@ -293,39 +293,69 @@ We are now ready to xref:#generate-website[generate the website].
 [#generate-website]
 == Generate website
 
-We use Antora to generate the site, not only the version being release but also any previous versions listed in `site.yml`.
-This is done using the `content.sources.url[].branches` properties.
-We use branches for all cases - note that the branch name appears in the generated UI.
-If there are patches to the documentation, we move the branches.
+We use Antora to generate the site, not only the version being release but also any previous versions listed in `site.yml`; each of these are tags.
+The most recent version is also tagged with the `latest` branch (updated each release); this means that neither the `antora.yml` files nor top-level `index.html` file needs to be updated.
+The `antora/playbooks/site.yml` _does_ need to be updated, but the `site-ALL.yml` file (alongside it) is used as a way to quickly make the necessary edits.
 
-We therefore temporarily modify all of the `antora.yml` files (and update `index.html`) file and create a branch for this change; then we update `site.yml` with a reference to that new branch.
-All of this is changed afterwards.
 
 [#create-doc-branch]
 === Create doc branch
 
-First, we update all versions in `antora.yml`:
+Update `site.yml` using `site.NEXT.yml`:
 
-* Update all `antora.yml` files:
+* move `site.yml` to one side, and replace with `site.NEXT.yml`:
 +
 [source,bash,subs="attributes+"]
 ----
-find . -name antora.yml -exec sed -i 's/latest/{page-causewayrel}/g' {} \;
+mv site.yml      site.ORIG.yml
+mv site.NEXT.yml site.yml
 ----
 
-* Commit all these changes:
+* update the new `site.yml`:
+
+** for each documentation component, add in a reference to a new branch `{page-causewayrel}` (we'll create it in the next step).
+Also make sure that the `latest` tag is also in the list; eg:
++
+[source,yaml,subs="attributes+"]
+.site.yml
+----
+content:
+  sources:
+    - url: .
+      start_path: antora/components/docs # docs
+      branches: [2.0.0-M5, ...  2.0.0-RC3, latest]
+      # ...
+    - url: .
+      start_path: viewers/wicket/adoc # vw
+      branches: [2.0.0-M5, ... 2.0.0-RC3, latest]
+----
+
+* also check that the attributes are correct.
++
+The value of the `page-causewayprev` attribute needs to be (the current) `{page-causewayrel}`, and `page-causewayrel` then set to the next likely release version:
++
+[source,yaml,subs="attributes+"]
+.site.yml
+----
+asciidoc:
+  attributes:
+    page-causewayprev: "..."
+    page-causewayrel: "..."
+----
+
+* commit the changes
 +
 [source,bash,subs="attributes+"]
 ----
 git add .
-git commit -m "$CAUSEWAYJIRA: bumps antora.yml versions to $CAUSEWAYREL"
+git commit -m "$CAUSEWAYJIRA: updates site.yml in readiness for website generation"
 ----
 
-We now create a branch to reference in the `site.yml`, later on.
+Now we ensure that the `{page-causewayrel}` branch and the `latest` tag refer to the current location:
 
-* We create the `{page-causewayrel}` branch.
+* create the `{page-causewayrel}` branch.
 +
-This mirrors the "rel/causeway-{page-causewayrel}" used for the formal (immutable) release tag, but is a branch because it allows us to move it, and must have this simplified name as it is used in the "edit page" link of the site template.
+This mirrors the "rel/causeway-{page-causewayrel}" used for the formal (immutable) release tag.
 +
 [source,bash,subs="attributes+"]
 ----
@@ -333,13 +363,17 @@ git branch {page-causewayrel}
 git push origin {page-causewayrel}
 ----
 
-Revert the last commit (backing out changes to `antora.yml` files):
-
+* update the `latest` branch.
+This name is used in the "edit page" link of the site template.
++
 [source,bash,subs="attributes+"]
 ----
-git revert HEAD
+git branch -f latest HEAD
+git push origin latest -f
 ----
 
+
+
 === Update the doc branch
 
 Now we make sure that the docs in the new doc branch are actually up-to-date:
@@ -348,7 +382,7 @@ Now we make sure that the docs in the new doc branch are actually up-to-date:
 +
 [source,bash,subs="attributes+"]
 ----
-git checkout {page-causewayrel}
+git checkout latest
 ----
 
 * build prereqs
@@ -356,9 +390,9 @@ git checkout {page-causewayrel}
 [source,bash,subs="attributes+"]
 ----
 pushd bom
-mvn clean install -T1C -DskipTests -Dgithub
+mvnd clean install -T1C -DskipTests -Dgithub
 popd
-mvn -D module-tooling -D skip.essential install -DskipTests
+mvnd -D module-tooling -D skip.essential install -DskipTests
 ----
 
 * generate the website:
@@ -382,38 +416,7 @@ git push origin {page-causewayrel}
 git checkout $CAUSEWAYBRANCH
 ----
 
-[#update-index-html-site-yml-generate]
-=== Update `index.html` & `site.yml` & generate
-
-Lastly, we update `index.html` and then `site.yml`
-
-* With the home page of the website, `antora/supplemental-ui/index.html`, update any mention of `latest` -> `{page-causewayrel}`
-+
-This should be in hyperlinks, `<a href="docs/...">`
-+
-NOTE: that this isn't performed in the docs branch (xref:#create-doc-branch[previous section]) because the supplemental files are _not_ versioned as a doc component:
-
-* Now update `site.yml`
-+
-This will reference the new branch, and any previous branches.
-Every content source needs to be updated:
-+
-** `branches: [2.0.0-RC2]` -> `branches: [2.0.0-M5, 2.0.0-M6, ... , {page-causewayrel}]`
-+
-[WARNING]
-====
-Actually though not every component is available from `2.0.0-M5`, which means that some manual adjustment is required, otherwise Antora will fail.
-
-Easiest thing to do is to use the `site.yml` git history to compare with its state when previous releases were made.
-====
-
-* commit this change, too (there's no need to push):
-+
-[source,bash,subs="attributes+"]
-----
-git add .
-git commit -m "$CAUSEWAYJIRA: updates references to version in index.html and site.yml"
-----
+=== Generate the site
 
 We are now in a position to actually generate the Antora website.
 
@@ -426,11 +429,25 @@ sh preview.sh -AS
 +
 This will write to `antora/target/site`; we'll use the results in the xref:#publish-website[next section].
 
-Finally, revert the last commit (backing out changes to `site.yml`):
 
+=== Revert changes
+
+Finally, restore the original `site.yml` file:
+
+* move the edited `site.yml` to `site.NEXT.yml` (in readiness for the _next_ release), and restore:
++
+[source,bash,subs="attributes+"]
+----
+mv site.yml      site.NEXT.yml
+mv site.ORIG.yml site.yml
+----
+
+* commit
++
 [source,bash,subs="attributes+"]
 ----
-git revert HEAD
+git add .
+git commit -m "$CAUSEWAYJIRA: reverts site.yml"
 ----
 
 


[causeway] 01/08: CAUSEWAY-3528 : adds site.NEXT.yml

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit deb1db7c2203b830dcd78f38781ba30a5e59046c
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 9 23:05:35 2023 +0100

    CAUSEWAY-3528 : adds site.NEXT.yml
---
 antora/playbooks/site.NEXT.yml | 142 ++++++++++++++++++++---------------------
 1 file changed, 71 insertions(+), 71 deletions(-)

diff --git a/antora/playbooks/site.NEXT.yml b/antora/playbooks/site.NEXT.yml
index fdef8e8801..f2488be7b2 100644
--- a/antora/playbooks/site.NEXT.yml
+++ b/antora/playbooks/site.NEXT.yml
@@ -26,250 +26,250 @@ content:
 # antora
     - url: .
       start_path: antora/components/docs # docs
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: antora/components/comguide # comguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: antora/components/conguide # conguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: antora/components/relnotes # relnotes
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: antora/components/setupguide # setupguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: antora/components/refguide # refguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: antora/components/refguide-index # refguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: antora/components/userguide # userguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # api
     - url: .
       start_path: api/schema/src/main/adoc # refguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # core
     - url: .
       start_path: core/adoc  # core (design docs)
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/codegen-bytebuddy/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: commons/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/config/src/main/adoc # refguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/interaction/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/internaltestsupport/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/metamodel/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/runtime/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/runtimeservices/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/security/src/main/adoc # security
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/transaction/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: core/webapp/src/main/adoc # core
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # examples
     - url: .
       start_path: antora/components/tutorials # tutorials
-      branches:           [2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:           [2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # extensions
     - url: .
       start_path: extensions/adoc # extensions
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
     - url: .
       start_path: extensions/core/commandlog/adoc # userguide
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/core/docgen/adoc # userguide
-      branches:                                                              [2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                                                              [2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/core/excel/adoc # userguide
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/core/executionlog/adoc # userguide
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/core/executionoutbox/adoc # userguide
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/core/executionrepublisher/adoc # userguide
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/core/flyway/adoc # userguide
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
     - url: .
       start_path: extensions/security/audittrail/adoc # security
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/security/secman/adoc # security
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/security/sessionlog/adoc # security
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/security/spring-oauth2/src/main/adoc # security
-      branches:                     [2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                     [2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
     - url: .
       start_path: extensions/vro/cors/adoc # vro
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
     - url: .
       start_path: extensions/vw/exceldownload/adoc # vw
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/vw/fullcalendar/adoc # vw
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/vw/pdfjs/adoc # vw
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: extensions/vw/sse/adoc # vw
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # incubator
     - url: .
       start_path: incubator/adoc # incubator
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 #   - url: .
 #     start_path: incubator/clients/kroviz/adoc # incubator
-#     branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+#     branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 #   - url: .
 #     start_path: incubator/extensions/core/commandreplay/adoc # incubator
-#     branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+#     branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: incubator/viewers/graphql/adoc # incubator
-      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                               [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # mavendeps
     - url: .
       start_path: mavendeps/adoc # starters
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # persistence
     - url: .
       start_path: persistence/jpa/adoc # pjpa
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: persistence/jdo/adoc # pjdo
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # regression tests
     - url: .
       start_path: regressiontests/adoc # regressiontests
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # security
     - url: .
       start_path: security/adoc # security
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: security/bypass/src/main/adoc # security
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: security/shiro/src/main/adoc # security
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: security/keycloak/src/main/adoc # security
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: security/spring/src/main/adoc # security
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # starters
     - url: .
       start_path: starters/adoc # toc
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 
 # testing
     - url: .
       start_path: testing/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/archtestsupport/adoc # testing
-      branches:                     [2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches:                     [2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/fakedata/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/fixtures/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/h2console/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/hsqldbmgr/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/integtestsupport/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/specsupport/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: testing/unittestsupport/adoc # testing
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # tooling
     - url: .
       start_path: tooling/adoc # toc
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: tooling/cli/adoc # cli
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # valuetypes
     - url: .
       start_path: valuetypes/adoc # valuetypes
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: valuetypes/asciidoc/adoc # valuetypes
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: valuetypes/jodatime/adoc # valuetypes
-      branches: [2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: valuetypes/markdown/adoc # valuetypes
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: valuetypes/vega/adoc # valuetypes
-      branches: [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 # viewers
     - url: .
       start_path: viewers/restfulobjects/adoc # vro
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
     - url: .
       start_path: viewers/wicket/adoc # vw
-      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3, latest]
+      branches: [2.0.0-M5, 2.0.0-M6, 2.0.0-M7, 2.0.0-M8, 2.0.0-M9, 2.0.0-RC1, 2.0.0-RC2, 2.0.0-RC3]
 
 
 ui:


[causeway] 02/08: CAUSEWAY-3528 : updates generated doc

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit d4caeaed798f0313f7f03ef40308abda6a69f188
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 9 23:06:35 2023 +0100

    CAUSEWAY-3528 : updates generated doc
---
 core/adoc/modules/_overview/pages/about.adoc | 54 ++--------------------------
 1 file changed, 2 insertions(+), 52 deletions(-)

diff --git a/core/adoc/modules/_overview/pages/about.adoc b/core/adoc/modules/_overview/pages/about.adoc
index 8def069f40..556bbaa23b 100644
--- a/core/adoc/modules/_overview/pages/about.adoc
+++ b/core/adoc/modules/_overview/pages/about.adoc
@@ -6380,32 +6380,7 @@ Artifact: causeway-regressiontests-stable
 Type: jar
 Directory: /regressiontests/stable
 ----
-|.Components
-****
-o.a.i.testdomain.conf.Configuration_headless$HeadlessCommandSupport +
-o.a.i.testdomain.jdo.JdoInventoryDao +
-o.a.i.testdomain.jdo.JdoTestFixtures +
-o.a.i.testdomain.jpa.JpaInventoryDao +
-o.a.i.testdomain.jpa.JpaTestFixtures +
-o.a.i.testdomain.jpa.springdata.EmployeeRepository +
-o.a.i.testdomain.model.valuetypes.ValueTypeExampleService +
-o.a.i.testdomain.publishing.PublishingTestFactoryAbstract$CommitListener +
-o.a.i.testdomain.publishing.PublishingTestFactoryJdo +
-o.a.i.testdomain.publishing.PublishingTestFactoryJpa +
-o.a.i.testdomain.publishing.subscriber.CommandSubscriberForTesting +
-o.a.i.testdomain.publishing.subscriber.EntityChangesSubscriberForTesting +
-o.a.i.testdomain.publishing.subscriber.EntityPropertyChangeSubscriberForTesting +
-o.a.i.testdomain.publishing.subscriber.ExecutionSubscriberForTesting +
-o.a.i.testdomain.util.event.LifecycleEventSubscriberJdoForTesting +
-o.a.i.testdomain.util.event.LifecycleEventSubscriberJpaForTesting +
-o.a.i.testdomain.util.interaction.DomainObjectTesterFactory +
-o.a.i.testdomain.util.interaction.InteractionBoundaryProbe +
-o.a.i.testdomain.util.kv.KVStoreForTesting +
-o.a.i.testdomain.util.rest.RestEndpointService +
-o.a.i.testdomain.wrapperfactory.CounterRepository +
-****
-
-.Dependencies
+|.Dependencies
 ****
 org.apache.causeway.extensions:causeway-extensions-fullcalendar-applib:jar:<managed> +
 org.apache.causeway.extensions:causeway-extensions-secman-encryption-jbcrypt:jar:<managed> +
@@ -6948,16 +6923,7 @@ Artifact: causeway-viewer-graphql-viewer
 Type: jar
 Directory: /incubator/viewers/graphql/viewer
 ----
-|.Components
-****
-o.a.i.viewer.graphql.viewer.source.ExecutionStrategyResolvingWithinInteraction +
-o.a.i.viewer.graphql.viewer.source.GraphQlServiceForCauseway +
-o.a.i.viewer.graphql.viewer.source.GraphQlSourceForCauseway +
-o.a.i.viewer.graphql.viewer.source.ObjectTypeFactory +
-o.a.i.viewer.graphql.viewer.source.QueryFieldFactory +
-****
-
-.Dependencies
+|.Dependencies
 ****
 org.apache.causeway.core:causeway-core-webapp:jar:<managed> +
 org.apache.causeway.incubator.viewer:causeway-viewer-graphql-model:jar:<managed> +
@@ -7043,12 +7009,6 @@ Directory: /incubator/extensions/core/commandreplay/primary
 ----
 |A module for obtaining commands from a primary
 
-.Components
-****
-o.a.i.extensions.commandreplay.primary.config.PrimaryConfig +
-o.a.i.extensions.commandreplay.primary.spiimpl.CaptureResultOfCommand +
-****
-
 .Dependencies
 ****
 org.apache.causeway.core:causeway-core-config:jar:<managed> +
@@ -7074,16 +7034,6 @@ Directory: /incubator/extensions/core/commandreplay/secondary
 |A module providing a Quartz Job to run on a secondary system,
 for obtaining commands from a primary and saving them so that they are replayed.
 
-.Components
-****
-o.a.i.extensions.commandreplay.secondary.analyser.CommandReplayAnalyserException +
-o.a.i.extensions.commandreplay.secondary.analyser.CommandReplayAnalyserResult +
-o.a.i.extensions.commandreplay.secondary.analysis.CommandReplayAnalysisService +
-o.a.i.extensions.commandreplay.secondary.config.SecondaryConfig +
-o.a.i.extensions.commandreplay.secondary.fetch.CommandFetcher +
-o.a.i.extensions.commandreplay.secondary.job.ReplicateAndReplayJob +
-****
-
 .Dependencies
 ****
 org.apache.causeway.core:causeway-core-config:jar:<managed> +


[causeway] 05/08: CAUSEWAY-3528: improves release docs, trivial

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch 2.0.0-RC3
in repository https://gitbox.apache.org/repos/asf/causeway.git

commit 81d5c615c6aee606f4065f47a5d852d7b0108e06
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Mon Oct 9 19:12:23 2023 +0100

    CAUSEWAY-3528: improves release docs, trivial
---
 .../comguide/modules/ROOT/pages/post-release-successful.adoc  | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

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 d5e6aa5a3f..3d48af9a78 100644
--- a/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
+++ b/antora/components/comguide/modules/ROOT/pages/post-release-successful.adoc
@@ -204,12 +204,13 @@ Next, add the new release into the appropriate directory.
 The `upd.sh` script can be used to automate this:
 
 [source,bash]
+.upd.sh
 ----
 new_ver=$1
 
 if [ $# -lt 1 ]; then
-        echo "usage: $(basename $0) version" 2>&1
-        exit 1
+  echo "usage: $(basename $0) version" 2>&1
+  exit 1
 fi
 
 # constants
@@ -225,9 +226,9 @@ sha512="$zip.sha512"
 
 for suffix in $zip $asc $md5 $sha1 $sha512
 do
-        echo curl -O $repo_root/$fullname/$new_ver/$fullname-$new_ver-$suffix
-        curl -O $repo_root/$fullname/$new_ver/$fullname-$new_ver-$suffix
-        svn add $fullname-$new_ver-$suffix
+  echo curl -O $repo_root/$fullname/$new_ver/$fullname-$new_ver-$suffix
+  curl -O $repo_root/$fullname/$new_ver/$fullname-$new_ver-$suffix
+  svn add $fullname-$new_ver-$suffix
 done
 ----