You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2017/03/06 20:09:07 UTC
[1/3] isis git commit: ISIS-1561: minor updates to release notes and
post-release procedures
Repository: isis
Updated Branches:
refs/heads/master e927b029b -> c531f7e48
ISIS-1561: minor updates to release notes and post-release procedures
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/9ba64b7a
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/9ba64b7a
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/9ba64b7a
Branch: refs/heads/master
Commit: 9ba64b7a9fe43fdad248aa1bdad23adc476a6ae0
Parents: e927b02
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Sun Feb 19 16:07:46 2017 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Sun Feb 19 16:07:46 2017 +0000
----------------------------------------------------------------------
.../_migration-notes_1.13.0-to-1.14.0.adoc | 8 ++--
.../guides/_cgcom_post-release-successful.adoc | 42 ++++++++++++++++++--
2 files changed, 43 insertions(+), 7 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/9ba64b7a/adocs/documentation/src/main/asciidoc/_migration-notes_1.13.0-to-1.14.0.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/_migration-notes_1.13.0-to-1.14.0.adoc b/adocs/documentation/src/main/asciidoc/_migration-notes_1.13.0-to-1.14.0.adoc
index 5cb7896..f36cfcf 100644
--- a/adocs/documentation/src/main/asciidoc/_migration-notes_1.13.0-to-1.14.0.adoc
+++ b/adocs/documentation/src/main/asciidoc/_migration-notes_1.13.0-to-1.14.0.adoc
@@ -12,7 +12,7 @@ This release defines a number of metamodel validations.
These can be enabled or disabled using configuration properties:
* `isis.reflector.validator.explicitObjectType` +
-
++
Whether to check that the class has an object type explicitly specified somehow.
This is strongly recommended, but is disabled by default to prevent migration issues.
@@ -22,7 +22,7 @@ Whether to check that the class name in JDOQL `FROM` clause matches or is a supe
This is enabled by default.
* `isis.reflector.validator.jdoqlVariablesClause` +
-
++
Whether to check that the class name in JDOQL `VARIABLES` clause is a recognized class.
This is enabled by default.
@@ -37,8 +37,8 @@ When searching for xref:rgcms.adoc#_rgcms_methods_prefixes_disable[`disableXxx(
This is disabled by default; if enabled then this makes for a simpler programming model.
* `isis.reflector.validator.serviceActionsOnly` +
-
++
Domain services are stateless (at least conceptually) and so should not have any properties or collections; any that are defined will not be rendered by the viewers. +
-
++
This is disabled by default; if enabled, then this ensure that domain services only declare actions and so makes for a simpler programming model.
http://git-wip-us.apache.org/repos/asf/isis/blob/9ba64b7a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
index 2d99ed0..d4407ec 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
@@ -407,7 +407,7 @@ git push
Once the Apache Isis release is available, all of the (non-ASF) link:http://isisaddons.org[Isis Addons] should also be released.
-Using this https://gist.github.com/danhaywood/ff17946ee05652402cfb[gist] to invoke operations across all (or selected) addons:
+Using this link:https://gist.github.com/danhaywood/21b5b885433fd8bc440da3fab88c91cb[gist] to invoke operations across all (or selected) addons:
* update its dependency on Apache Isis to reference the newly released version: +
+
@@ -425,11 +425,47 @@ foreach -g isisaddons bumpver_isis.sh 1.14.0
** update the "Change Log" section
-* release to mvn central (contains a sanity check before hand that everything compiles): +
+* release the metamodel/module/wicket modules to mvn central (contains a sanity check before hand that everything compiles): +
+
[source,bash]
----
-foreach -g isisaddons sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
+foreach -g isisaddons/isis-[mw] sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
+----
+
+* update its dependency on Apache Isis to reference the next SNAPSHOT version: +
++
+[source,bash]
+----
+foreach -g isisaddons sh bumpver_isis.sh "1.15.0-SNAPSHOT"
+----
+
+== Release Incode Catalog Modules
+
+Similarly, all of the (non-ASF) link:http://catalog.incode.org[Incode Catalog] modules should also be released.
+
+Using this link:https://gist.github.com/danhaywood/21b5b885433fd8bc440da3fab88c91cb[gist] to invoke operations across all (or selected) addons:
+
+* update its dependency on Apache Isis to reference the newly released version: +
++
+[source,bash]
+----
+foreach -g incodehq/incode- bumpver_isis.sh 1.14.0
+----
+
+* update the README for each repository
+
+** replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
+
+*** replace 1.14.0-SNAPSHOT with 1.15.0-SNAPSHOT
+*** replace 1.13.0 with 1.14.0
+
+** update the "Change Log" section
+
+* release the `incode-module-???` modules to mvn central (contains a sanity check before hand that everything compiles): +
++
+[source,bash]
+----
+foreach -g incodehq/incode-[a-w] sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
----
* update its dependency on Apache Isis to reference the next SNAPSHOT version: +
[3/3] isis git commit: ISIS-1561: updates to post-release docs
Posted by da...@apache.org.
ISIS-1561: updates to post-release docs
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/c531f7e4
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/c531f7e4
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/c531f7e4
Branch: refs/heads/master
Commit: c531f7e48048129bf690e0294f2a16cdd14d374e
Parents: d26d3a5
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri Feb 24 17:09:26 2017 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri Feb 24 17:09:26 2017 +0000
----------------------------------------------------------------------
.../guides/_cgcom_post-release-successful.adoc | 44 +++++++++++++++++++-
1 file changed, 43 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/c531f7e4/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
index 389c017..e1c7013 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
@@ -430,7 +430,12 @@ For example, if the isisaddons modules are cloned to `/c/github/isisaddons/isis-
The `org.incode:incode-parent` Maven module is used as a parent for both sets of modules:
-* Open up `pom.xml`, and manually edit `<isis.version>` property to the latest release
+* update its dependency on Apache Isis to reference the newly released version: +
++
+[source,bash]
+----
+sh bumpver_isis.sh 1.14.0
+----
* update the README
@@ -450,6 +455,43 @@ sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" "this is
+[[_cgcom_post-release-successful_release-non-asf-modules_incode-mavendeps]]
+=== Release `incode-mavendeps`
+
+The three `org.incode:mavendeps-isisXXX` module should be released next.
+
+* update its dependency on Apache Isis to reference the newly released version: +
++
+[source,bash]
+----
+foreach -g incodehq/mavendeps sh bumpver_isis.sh 1.14.0
+----
+
+* update the README
+
+** replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
+
+*** replace 1.14.0-SNAPSHOT with 1.15.0-SNAPSHOT
+*** replace 1.13.0 with 1.14.0
+
+** update the "Change Log" section
+
+* Release using: +
++
+[source,bash]
+----
+foreach -g incodehq/mavendeps sh sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
+----
+
+* update its dependency on Apache Isis to reference the next SNAPSHOT: +
++
+[source,bash]
+----
+foreach -g incodehq/mavendeps sh bumpver_isis.sh 1.15.0-SNAPSHOT
+----
+
+
+
[[_cgcom_post-release-successful_release-non-asf-modules_isisaddons]]
=== Release Isis Addons
[2/3] isis git commit: ISIS-1561: updates to post-release procedures
Posted by da...@apache.org.
ISIS-1561: updates to post-release procedures
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/d26d3a51
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/d26d3a51
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/d26d3a51
Branch: refs/heads/master
Commit: d26d3a51233f9a7317430160abeefebfb41f590d
Parents: 9ba64b7
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Feb 21 00:01:00 2017 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Feb 21 00:01:00 2017 +0000
----------------------------------------------------------------------
adocs/documentation/Gemfile.lock | 3 -
.../guides/_cgcom_post-release-successful.adoc | 178 +++++++++++++++++--
2 files changed, 162 insertions(+), 19 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/d26d3a51/adocs/documentation/Gemfile.lock
----------------------------------------------------------------------
diff --git a/adocs/documentation/Gemfile.lock b/adocs/documentation/Gemfile.lock
index 9b483db..0d4f467 100644
--- a/adocs/documentation/Gemfile.lock
+++ b/adocs/documentation/Gemfile.lock
@@ -45,6 +45,3 @@ DEPENDENCIES
tilt
wdm (>= 0.1.0)
webrick
-
-BUNDLED WITH
- 1.10.6
http://git-wip-us.apache.org/repos/asf/isis/blob/d26d3a51/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
index d4407ec..389c017 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cgcom_post-release-successful.adoc
@@ -403,7 +403,55 @@ git push
----
-== Release Isis Addons
+
+[[_cgcom_post-release-successful_release-non-asf-modules]]
+== Release (non-ASF) Modules
+
+There are two libraries of modules, both non-ASF but open source, that should be released.
+
+* link:http://isisaddons.org[Isis Addons] - modules addressing technical concerns
+* link:http://catalog.incodehq.org[Incode Catalog] - modules for various generic business subdomains
+
+These each use a common parent, `org.incode:incode-parent`.
+This must be released first, then both set of modules afterwards.
+
+
+[[_cgcom_post-release-successful_release-non-asf-modules_prereqs]]
+=== Prereqs
+
+Save this link:https://gist.github.com/danhaywood/e80daf6d25f5c1fb1093effba85d088a[gist] as `last_modified.sh` in an appropriate parent directory of both sets of repos.
+
+For example, if the isisaddons modules are cloned to `/c/github/isisaddons/isis-module-xxx` and the incode catalog modules are cloned to `/c/github/incodehq/incode-module-xxx`, then save in `/c/github`.
+
+
+
+[[_cgcom_post-release-successful_release-non-asf-modules_incode-parent]]
+=== Release `incode-parent`
+
+The `org.incode:incode-parent` Maven module is used as a parent for both sets of modules:
+
+* Open up `pom.xml`, and manually edit `<isis.version>` property to the latest release
+
+* update the README
+
+** replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
+
+*** replace 1.14.0-SNAPSHOT with 1.15.0-SNAPSHOT
+*** replace 1.13.0 with 1.14.0
+
+** update the "Change Log" section
+
+* Release using: +
++
+[source,bash]
+----
+sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" "this is not really my password"
+----
+
+
+
+[[_cgcom_post-release-successful_release-non-asf-modules_isisaddons]]
+=== Release Isis Addons
Once the Apache Isis release is available, all of the (non-ASF) link:http://isisaddons.org[Isis Addons] should also be released.
@@ -413,15 +461,38 @@ Using this link:https://gist.github.com/danhaywood/21b5b885433fd8bc440da3fab88c9
+
[source,bash]
----
-foreach -g isisaddons bumpver_isis.sh 1.14.0
+foreach -g isisaddons sh bumpver_isis.sh 1.14.0
+----
++
+and use: +
++
+[source,bash]
+----
+foreach -g isisaddons git diff HEAD^ HEAD
+----
++
+and: +
++
+[source,bash]
+----
+foreach -g isisaddons git status --branch --porcelain
----
++
+to review changes made.
+
+* update the README for each repository.
-* update the README for each repository
+** if using Windows, then: +
++
+[source,bash]
+----
+"C:\Program Files (x86)\Notepad++\notepad++.exe" isisaddons/isis-m*/README.adoc isisaddons/isis-w*/README.adoc
+----
** replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
-*** replace 1.14.0-SNAPSHOT with 1.15.0-SNAPSHOT
-*** replace 1.13.0 with 1.14.0
+*** replace `1.14.0` with `1.15.0`
+*** replace `1.13.0` with `1.14.0` as necessary (pretty much everywhere apart from the "Change Log")
** update the "Change Log" section
@@ -432,14 +503,28 @@ foreach -g isisaddons bumpver_isis.sh 1.14.0
foreach -g isisaddons/isis-[mw] sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
----
-* update its dependency on Apache Isis to reference the next SNAPSHOT version: +
+* In the parent directory where the `last_modified.sh` script has been saved (see xref:cgcom.adoc#_cgcom_post-release-successful_release-non-asf-modules_prereqs[above]), use to check that all modules were released successfully: +
+
[source,bash]
----
-foreach -g isisaddons sh bumpver_isis.sh "1.15.0-SNAPSHOT"
+foreach -g isisaddons/isis-[mw] sh ../../last-modified.sh 1.14.0
----
++
+[IMPORTANT]
+====
+Wait at least 10 minutes to check; sync'ing to Maven central from the Sonatype OSS repository isn't instaneous.
+====
-== Release Incode Catalog Modules
+* Assuming everything did get published ok, then push branch and tag: +
++
+[source,bash]
+----
+foreach -g isisaddons/isis-[mw] "git push origin master && git push origin 1.14.0"
+----
+
+
+[[_cgcom_post-release-successful_release-non-asf-modules_incode-catalog]]
+=== Release Incode Catalog Modules
Similarly, all of the (non-ASF) link:http://catalog.incode.org[Incode Catalog] modules should also be released.
@@ -449,29 +534,90 @@ Using this link:https://gist.github.com/danhaywood/21b5b885433fd8bc440da3fab88c9
+
[source,bash]
----
-foreach -g incodehq/incode- bumpver_isis.sh 1.14.0
+foreach -g incodehq/incode-module sh bumpver_isis.sh 1.14.0
----
-* update the README for each repository
+* update the README for each repository. +
++
+eg if using Windows, then:
++
+[source,bash]
+----
+"C:\Program Files (x86)\Notepad++\notepad++.exe" incodehq/incode-*/README.adoc
+----
-** replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
+** Replace each version with next (ie the "How to Configure/Use" section, and the "Release to Maven Central" section at the end):
-*** replace 1.14.0-SNAPSHOT with 1.15.0-SNAPSHOT
-*** replace 1.13.0 with 1.14.0
+*** replace `1.14.0` with `1.15.0`
+*** replace `1.13.0` with `1.14.0` as necessary (pretty much everywhere apart from the "Change Log")
** update the "Change Log" section
+* update cross-module dependencies +
++
+Some of the incode catalog modules depend on isisaddons modules, and also on each other. +
++
+eg if using Windows, then: +
++
+[source,bash]
+----
+"C:\Program Files (x86)\Notepad++\notepad++.exe" incodehq/incode-module*/pom.xml incodehq/incode-module-*/dom/pom.xml incodehq/incode-module-*/module/pom.xml
+----
++
+[TIP]
+====
+See xref:cgcom.adoc#_cgcom_post-release-successful_release-non-asf-modules_incode-catalog_cross-module-dependencies[below] for a list of the dependencies to update.
+====
+
+* If necessary, adjust the `_repos.txt` file (used by `foreach` function) so that repositories are released in the correct sequence (with respect to their mutual dependencies).
+For example, `incode-module-base` must be released prior to `incode-module-alias`.
+
* release the `incode-module-???` modules to mvn central (contains a sanity check before hand that everything compiles): +
+
[source,bash]
----
-foreach -g incodehq/incode-[a-w] sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
+foreach -g incodehq/incode-module-[a-w] sh release.sh "1.14.0" "1.15.0-SNAPSHOT" "dan@haywood-associates.co.uk" \"this is not really my password\"
+----
+
+* In the parent directory where the `last_modified.sh` script has been saved (see xref:cgcom.adoc#_cgcom_post-release-successful_release-non-asf-modules_prereqs[above]), use to check that all modules were released successfully: +
++
+[source,bash]
+----
+foreach -g incodehq/incode-module-[a-w] sh ../../last-modified.sh 1.14.0
----
++
+[IMPORTANT]
+====
+Wait at least 10 minutes to check; sync'ing to Maven central from the Sonatype OSS repository isn't instaneous.
+====
-* update its dependency on Apache Isis to reference the next SNAPSHOT version: +
+* Assuming everything did get published ok, then push branch and tag: +
+
[source,bash]
----
-foreach -g isisaddons sh bumpver_isis.sh "1.15.0-SNAPSHOT"
+foreach -g incodehq/incode-module-[a-w] "git push origin master && git push origin 1.14.0"
----
+
+[[_cgcom_post-release-successful_release-non-asf-modules_incode-catalog_cross-module-dependencies]]
+==== Cross-module dependencies
+
+As of v1.14.0, the list of dependencies that needed to be updated (across all modules) were:
+
+** `<isis-module-fakedata.version>1.14.0</isis-module-fakedata.version>`
+** `<isis-module-freemarker.version>1.14.0</isis-module-freemarker.version>`
+** `<isis-wicket-fullcalendar2-cpt.version>1.14.0</isis-wicket-fullcalendar2-cpt.version>`
+** `<isis-wicket-gmap3-cpt.version>1.14.0</isis-wicket-gmap3-cpt.version>`
+** `<isis-module-poly.version>1.14.0</isis-module-poly.version>`
+** `<isis-module-security.version>1.14.0</isis-module-security.version>`
+** `<incode-module-base.version>1.14.0</incode-module-base.version>`
+** `<incode-module-fixturesupport.version>1.14.0</incode-module-fixturesupport.version>`
+** `<incode-module-unittestsupport.version>1.14.0</incode-module-unittestsupport.version>`
+** `<incode-module-integtestsupport.version>1.14.0</incode-module-integtestsupport.version>`
+** `<incode-module-country.version>1.14.0</incode-module-country.version>`
+** `<incode-module-document.version>1.14.0</incode-module-document.version>`
+** `<incode-module-docrendering-freemarker.version>1.14.0</incode-module-docrendering-freemarker.version>`
+** `<incode-module-docrendering-stringinterpolator.version>1.14.0</incode-module-docrendering-stringinterpolator.version>`
+** `<incode-module-docrendering-xdocreport.version>1.14.0</incode-module-docrendering-xdocreport.version>`
+
+