This is an automated email from the ASF dual-hosted git repository.
ahuber pushed a commit to branch maintenance-branch
in repository https://gitbox.apache.org/repos/asf/causeway.git
The following commit(s) were added to refs/heads/maintenance-branch by this
push:
new 0a445e19251 CAUSEWAY-3952: [v2] adds build instructions to README
0a445e19251 is described below
commit 0a445e19251b3e5de1e3d7e815e2f3d5107f6d5f
Author: andi-huber <[email protected]>
AuthorDate: Fri Jan 16 10:47:21 2026 +0100
CAUSEWAY-3952: [v2] adds build instructions to README
---
README.adoc | 35 ++++++++++++++++++++++++++++++++++-
1 file changed, 34 insertions(+), 1 deletion(-)
diff --git a/README.adoc b/README.adoc
index 7c90412b2f6..0933b1a63bc 100644
--- a/README.adoc
+++ b/README.adoc
@@ -5,4 +5,37 @@ This branch is in the process of being decommissioned.
Version `2.1.0` was the very last _2.x_ release.
For _Apache Causeway_ documentation see: https://causeway.apache.org/
-
\ No newline at end of file
+
+== Build your own (Version `2.x`)
+
+Here are the recommended build instructions:
+
+- use sdkman see https://sdkman.io
+- install _Maven 3.9.12_ `sdk install maven 3.9.12`
+- install _Java 25_ `sdk install java 25.0.1-tem`
+- verify Maven and Java versions are as desired: `mvn -v`
+
+Now build with _mvn_ command:
+----
+mvn install \
+ -Drevision=2.2.0-SNAPSHOT \
+ -Dmaven.compiler.release=11 \
+ -Dmaven.compiler.proc=full \
+ -Dmaven.source.skip=true \
+ -Dmodule-regressiontests \
+ -T 6 \
+ -e
+----
+
+Note: the `revision` parameter can be set as desired
+
+== Legacy (isis) Build
+
+Before running the the above `mvn install ...` one has to run:
+----
+export ROOT_PATH_LEGACY=$(pwd)
+jshell scripts/ci/rename-all-published-sources.jsh
+----
+
+This will rename artifacts and packages from `causeway` to `isis`.
+
