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 2019/01/06 18:02:39 UTC

[isis] 02/06: ISIS-1899: updates docs for 1.17.0 release

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

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

commit 017eacb740942015d0ad70ed4f2a3ca6d53235f8
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Sun Jan 6 16:03:05 2019 +0000

    ISIS-1899: updates docs for 1.17.0 release
---
 STATUS                                             |  4 +
 .../src/main/asciidoc/__versions.adoc              |  6 +-
 .../documentation/src/main/asciidoc/doap_isis.rdf  | 48 ++++++++++++
 .../documentation/src/main/asciidoc/downloads.adoc | 12 +--
 .../cgcom/_cgcom_post-release-successful.adoc      |  6 ++
 adocs/documentation/src/main/asciidoc/index.html   |  4 +-
 .../src/main/asciidoc/pages/tg/tg.adoc             |  2 +-
 .../release-notes/_release-notes_1.17.0.adoc       | 88 +++++++++++++++++++++-
 8 files changed, 157 insertions(+), 13 deletions(-)

diff --git a/STATUS b/STATUS
index 893c0a6..31949e7 100644
--- a/STATUS
+++ b/STATUS
@@ -20,6 +20,10 @@ Description
 
 TLP releases:
 
+  * isis-1.17.0                                    :  6 Jan 2019
+  * helloworld-archetype-1.17.0                    :  6 Jan 2019
+  * simpleapp-archetype-1.17.0                     :  6 Jan 2019
+
   * isis-2.0.0-M1                                  : 31 Jul 2018
   * helloworld-archetype-2.0.0-M1                  : 31 Jul 2018
   * simpleapp-archetype-2.0.0-M1                   : 31 Jul 2018
diff --git a/adocs/documentation/src/main/asciidoc/__versions.adoc b/adocs/documentation/src/main/asciidoc/__versions.adoc
index c6c07dc..f52216c 100644
--- a/adocs/documentation/src/main/asciidoc/__versions.adoc
+++ b/adocs/documentation/src/main/asciidoc/__versions.adoc
@@ -1,4 +1,4 @@
-:isiscurr: 1.16.2
-:isisnext: 1.17.0
-:isisnextafter: 1.18.0
+:isiscurr: 1.17.0
+:isisnext: 1.18.0
+:isisnextafter: 1.19.0
 :isisdevafter: {isisnextafter}-SNAPSHOT
\ No newline at end of file
diff --git a/adocs/documentation/src/main/asciidoc/doap_isis.rdf b/adocs/documentation/src/main/asciidoc/doap_isis.rdf
index ade0283..bc09e78 100644
--- a/adocs/documentation/src/main/asciidoc/doap_isis.rdf
+++ b/adocs/documentation/src/main/asciidoc/doap_isis.rdf
@@ -36,6 +36,54 @@
     <category rdf:resource="http://projects.apache.org/category/web-framework" />
 
     
+    <!-- 2019-01-06 releases -->
+    <release>
+      <Version>
+        <name>isis</name>
+        <created>2019-01-06</created>
+        <revision>1.17.0</revision>
+      </Version>
+    </release>
+    <release>
+      <Version>
+        <name>helloworld-archetype</name>
+        <created>2019-01-06</created>
+        <revision>1.17.0</revision>
+      </Version>
+    </release>
+    <release>
+      <Version>
+        <name>simpleapp-archetype</name>
+        <created>2019-01-06</created>
+        <revision>1.17.0</revision>
+      </Version>
+    </release>
+
+
+    <!-- 2018-07-31 releases -->
+    <release>
+      <Version>
+        <name>isis</name>
+        <created>2018-07-31</created>
+        <revision>2.0.0-M1</revision>
+      </Version>
+    </release>
+    <release>
+      <Version>
+        <name>helloworld-archetype</name>
+        <created>2018-07-31</created>
+        <revision>2.0.0-M1</revision>
+      </Version>
+    </release>
+    <release>
+      <Version>
+        <name>simpleapp-archetype</name>
+        <created>2018-07-31</created>
+        <revision>2.0.0-M1</revision>
+      </Version>
+    </release>
+
+
     <!-- 2018-03-05 releases -->
     <release>
       <Version>
diff --git a/adocs/documentation/src/main/asciidoc/downloads.adoc b/adocs/documentation/src/main/asciidoc/downloads.adoc
index 7fac77f..f9cd2cc 100644
--- a/adocs/documentation/src/main/asciidoc/downloads.adoc
+++ b/adocs/documentation/src/main/asciidoc/downloads.adoc
@@ -25,15 +25,15 @@ If you want to build Apache Isis from formally released source tarballs, you can
 
 Core:
 
-* https://www.apache.org/dyn/closer.cgi/isis/isis-core/isis-1.16.2-source-release.zip[isis-1.16.2] (https://www.apache.org/dist/isis/isis-core/isis-1.16.2-source-release.zip.asc[asc], https://www.apache.org/dist/isis/isis-core/isis-1.16.2-source-release.zip.md5[md5])
+* https://www.apache.org/dyn/closer.cgi/isis/isis-core/isis-1.17.0-source-release.zip[isis-1.17.0] (https://www.apache.org/dist/isis/isis-core/isis-1.17.0-source-release.zip.asc[asc], https://www.apache.org/dist/isis/isis-core/isis-1.17.0-source-release.zip.md5[md5])
 
 HelloWorld Archetype:
 
-* https://www.apache.org/dyn/closer.cgi/isis/archetype/helloworld-archetype/helloworld-archetype-1.16.2-source-release.zip[helloworld-archetype-1.16.2] (https://www.apache.org/dist/isis/archetype/helloworld-archetype/helloworld-archetype-1.16.2-source-release.zip.asc[asc], https://www.apache.org/dist/isis/archetype/helloworld-archetype/helloworld-archetype-1.16.2-source-release.zip.md5[md5])
+* https://www.apache.org/dyn/closer.cgi/isis/archetype/helloworld-archetype/helloworld-archetype-1.17.0-source-release.zip[helloworld-archetype-1.17.0] (https://www.apache.org/dist/isis/archetype/helloworld-archetype/helloworld-archetype-1.17.0-source-release.zip.asc[asc], https://www.apache.org/dist/isis/archetype/helloworld-archetype/helloworld-archetype-1.17.0-source-release.zip.md5[md5])
 
 SimpleApp Archetype:
 
-* https://www.apache.org/dyn/closer.cgi/isis/archetype/simpleapp-archetype/simpleapp-archetype-1.16.2-source-release.zip[simpleapp-archetype-1.16.2] (https://www.apache.org/dist/isis/archetype/simpleapp-archetype/simpleapp-archetype-1.16.2-source-release.zip.asc[asc], https://www.apache.org/dist/isis/archetype/simpleapp-archetype/simpleapp-archetype-1.16.2-source-release.zip.md5[md5])
+* https://www.apache.org/dyn/closer.cgi/isis/archetype/simpleapp-archetype/simpleapp-archetype-1.17.0-source-release.zip[simpleapp-archetype-1.17.0] (https://www.apache.org/dist/isis/archetype/simpleapp-archetype/simpleapp-archetype-1.17.0-source-release.zip.asc[asc], https://www.apache.org/dist/isis/archetype/simpleapp-archetype/simpleapp-archetype-1.17.0-source-release.zip.md5[md5])
 
 
 
@@ -50,7 +50,7 @@ Then verify the signatures using a command such as:
 [source,bash]
 ----
 pgpk -a KEYS
-pgpv isis-1.16.2-source-release.zip.asc isis-1.16.2-source-release.zip
+pgpv isis-1.17.0-source-release.zip.asc isis-1.17.0-source-release.zip
 ----
 
 or
@@ -58,7 +58,7 @@ or
 [source,bash]
 ----
 pgp -ka KEYS
-pgp isis-1.16.2-source-release.zip.asc isis-1.16.2-source-release.zip
+pgp isis-1.17.0-source-release.zip.asc isis-1.17.0-source-release.zip
 ----
 
 or
@@ -66,7 +66,7 @@ or
 [source,bash]
 ----
 gpg –import KEYS
-gpg -verify isis-1.16.2-source-release.zip.asc isis-1.16.2-source-release.zip
+gpg -verify isis-1.17.0-source-release.zip.asc isis-1.17.0-source-release.zip
 ----
 
 
diff --git a/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc b/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
index c12807f..0f1b123 100644
--- a/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/cgcom/_cgcom_post-release-successful.adoc
@@ -229,6 +229,12 @@ From the root directory, generate the release notes for the current release, in
 sh scripts/jira-release-notes.sh ISIS {isisnext} > /tmp/1
 ----
 
+[NOTE]
+====
+This script uses 'jq' to parse JSON.
+See the script itself for details of how to install this utility.
+====
+
 
 === Close tickets
 
diff --git a/adocs/documentation/src/main/asciidoc/index.html b/adocs/documentation/src/main/asciidoc/index.html
index 53e9685..e4afce0 100644
--- a/adocs/documentation/src/main/asciidoc/index.html
+++ b/adocs/documentation/src/main/asciidoc/index.html
@@ -652,7 +652,7 @@ table.CodeRay td.code>pre{padding:0}
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=helloworld-archetype \
-    -D archetypeVersion=1.16.2 \
+    -D archetypeVersion=1.17.0 \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \
@@ -668,7 +668,7 @@ mvn archetype:generate  \
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.16.2 \
+    -D archetypeVersion=1.17.0 \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \
diff --git a/adocs/documentation/src/main/asciidoc/pages/tg/tg.adoc b/adocs/documentation/src/main/asciidoc/pages/tg/tg.adoc
index 436b8b5..a08e811 100644
--- a/adocs/documentation/src/main/asciidoc/pages/tg/tg.adoc
+++ b/adocs/documentation/src/main/asciidoc/pages/tg/tg.adoc
@@ -35,7 +35,7 @@ With the *nix bash shell, use:
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.16.2 \
+    -D archetypeVersion=1.17.0 \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \
diff --git a/adocs/documentation/src/main/asciidoc/release-notes/_release-notes_1.17.0.adoc b/adocs/documentation/src/main/asciidoc/release-notes/_release-notes_1.17.0.adoc
index d91e862..8b21577 100644
--- a/adocs/documentation/src/main/asciidoc/release-notes/_release-notes_1.17.0.adoc
+++ b/adocs/documentation/src/main/asciidoc/release-notes/_release-notes_1.17.0.adoc
@@ -6,5 +6,91 @@
 :toc: right
 
 
-This release ...
+This two main features in this release are the ability for dialog actions to be use a sidebar rather than a modal dialog (link:https://issues.apache.org/jira/browse/ISIS-1997[ISIS-1997]), and the ability to export the metamodel as XML (link:https://issues.apache.org/jira/browse/ISIS-2003[ISIS-2003]).
 
+With respect to general improvements, for the end-user they hopefully will notice that tabbing behaviour around the UI is much improved (link:https://issues.apache.org/jira/browse/ISIS-2053[ISIS-2053]), while internally the way in which the metamodel is built up has been revamped so that this is now done in parallel (link:https://issues.apache.org/jira/browse/ISIS-1974[ISIS-1974]).
+It's also possible to more fully customise the footer (link:https://issues.apache.org/jira/browse/ISIS-2009[ISIS-2009], link:https://issues.apache.org/jira/browse/ISIS-2022[ISIS-2022]), and new configuration properties mean that in many cases there should no longer be any need to subclass `IsisWicketApplication` (link:https://issues.apache.org/jira/browse/ISIS-2023[ISIS-2023]).
+
+In terms of notable bugs, there have been several fixes for the Restful Objects viewer (link:https://issues.apache.org/jira/browse/ISIS-2046[ISIS-2046], link:https://issues.apache.org/jira/browse/ISIS-2045[ISIS-2045]).
+
+
+== New Feature
+
+* link:https://issues.apache.org/jira/browse/ISIS-2043[ISIS-2043] - Allow domain events to be specified at @DomainObject, and make mixins aware of this.
+* link:https://issues.apache.org/jira/browse/ISIS-2027[ISIS-2027] - Provide a health endpoint (eg for Docker orchestrators to monitor).
+* link:https://issues.apache.org/jira/browse/ISIS-2003[ISIS-2003] - Serialize representation of metamodel to allow before/after checking
+* link:https://issues.apache.org/jira/browse/ISIS-1997[ISIS-1997] - For an alternative for non-obtrusive bulk entry of info, use a sidebar as action prompt (for top-level actions only).
+
+
+== Improvement
+
+* link:https://issues.apache.org/jira/browse/ISIS-2057[ISIS-2057] - JaxbServiceDefault should handle entity if isn't annotated with XmlJavaTypeAdapter
+* link:https://issues.apache.org/jira/browse/ISIS-2053[ISIS-2053] - Improve tabbing behaviour
+* link:https://issues.apache.org/jira/browse/ISIS-2050[ISIS-2050] - Install ObjectSpecIdFacet immediately on creation of ObjectSpecification so can be cached.
+* link:https://issues.apache.org/jira/browse/ISIS-2025[ISIS-2025] - Extend WrapperFactory with new execution mode to "try" to execute.
+* link:https://issues.apache.org/jira/browse/ISIS-2024[ISIS-2024] - Centre image or text on sign-in page.
+* link:https://issues.apache.org/jira/browse/ISIS-2023[ISIS-2023] - Add additional config properties so there is little need to subclass IsisWicketApplication
+* link:https://issues.apache.org/jira/browse/ISIS-2022[ISIS-2022] - Show application version in footer if available as config property.
+* link:https://issues.apache.org/jira/browse/ISIS-2021[ISIS-2021] - Allow initial bootswatch theme to be specified via configuration property
+* link:https://issues.apache.org/jira/browse/ISIS-2009[ISIS-2009] - Allow footer to be customised with multiple credits
+* link:https://issues.apache.org/jira/browse/ISIS-2008[ISIS-2008] - Add null guards in Blob and Clob, to detect errors in application code early
+* link:https://issues.apache.org/jira/browse/ISIS-1977[ISIS-1977] - Improve flattening for -Drevision=...
+* link:https://issues.apache.org/jira/browse/ISIS-1974[ISIS-1974] - Reduce time to bootstrap
+* link:https://issues.apache.org/jira/browse/ISIS-1966[ISIS-1966] - Introduce extension of HasTransactionId that includes sequence number
+* link:https://issues.apache.org/jira/browse/ISIS-1916[ISIS-1916] - enhance archetype so runs out-of-the-box in gitlab CI
+* link:https://issues.apache.org/jira/browse/ISIS-1913[ISIS-1913] - Extend REST API to return object icon
+* link:https://issues.apache.org/jira/browse/ISIS-1912[ISIS-1912] - simpleapp 1.16.2 archetype is missing webapp/resources/Dockerfile
+* link:https://issues.apache.org/jira/browse/ISIS-1888[ISIS-1888] - Tweak/add CSS class names to better support E2E tests (page object selectors)
+
+
+== Bug
+
+* link:https://issues.apache.org/jira/browse/ISIS-2061[ISIS-2061] - Fix rendering of date/time in sidebar dialog
+* link:https://issues.apache.org/jira/browse/ISIS-2046[ISIS-2046] - RO viewer should honour x-ro-validate-only
+* link:https://issues.apache.org/jira/browse/ISIS-2045[ISIS-2045] - RO viewer does not render body correctly when action validation fails.
+* link:https://issues.apache.org/jira/browse/ISIS-1985[ISIS-1985] - Incomplete Metamodel Validation
+* link:https://issues.apache.org/jira/browse/ISIS-1965[ISIS-1965] - Enable CI/CD for maint-1.16.3
+* link:https://issues.apache.org/jira/browse/ISIS-1964[ISIS-1964] - ConcurrentModificationException when stating application
+* link:https://issues.apache.org/jira/browse/ISIS-1925[ISIS-1925] - Invoking an action on an entity with contributed blobs (or clobs) returning null will result in an NPE.
+* link:https://issues.apache.org/jira/browse/ISIS-1902[ISIS-1902] - Datanucles: plugging in of Isis provided JDO value types is broken
+* link:https://issues.apache.org/jira/browse/ISIS-1485[ISIS-1485] - MessageService#informUser(...) doesn't seem to be raising an alert for an action returning a Blob
+
+
+== Documentation
+
+* link:https://issues.apache.org/jira/browse/ISIS-2051[ISIS-2051] - Amend ugrov
+
+
+== Task
+
+* link:https://issues.apache.org/jira/browse/ISIS-1899[ISIS-1899] - Release tasks for 1.17.0
+
+
+== Won't Fix / Not a Problem / Duplicates
+
+* link:https://issues.apache.org/jira/browse/ISIS-1996[ISIS-1996] - [DUPLICATE, WON'T FIX] For non-obtrusive bulk entry of info, use panel/fieldset as action prompt (for actions associated with panel).
+* link:https://issues.apache.org/jira/browse/ISIS-1992[ISIS-1992] - [WON'T FIX] Actions associated with the panel should optionally be rendered "in-place" (rather than modal).
+* link:https://issues.apache.org/jira/browse/ISIS-1986[ISIS-1986] - skinnywar support (backport from v2)
+* link:https://issues.apache.org/jira/browse/ISIS-1539[ISIS-1539] - [WON'T FIX] Incorporate isisaddons' command module as part of Isis core.
+* link:https://issues.apache.org/jira/browse/ISIS-1272[ISIS-1272] - [WON'T FIX[ Facet factory for actions called "changeXxx" or "maintainXxx" to be positioned to RIGHT, with dropdown.
+* link:https://issues.apache.org/jira/browse/ISIS-1248[ISIS-1248] - [WON'T FIX] Lombok plugin to automatically generate domain event classes.
+* link:https://issues.apache.org/jira/browse/ISIS-989[ISIS-989] - [WON'T FIX] Allow data being stored to be encrypted, leveraging Cumulus4J
+* link:https://issues.apache.org/jira/browse/ISIS-573[ISIS-573] - [WON'T FIX] To improve performance, set up caching of query results against any entities that are immutable (ie ref data, ie have ImmutableFacet on them).
+* link:https://issues.apache.org/jira/browse/ISIS-507[ISIS-507] - [WON'T FIX] UI: more specific icon for bookmarked repository actions
+* link:https://issues.apache.org/jira/browse/ISIS-741[ISIS-741] - [WON'T FIX] For GSOC, write an integration with Twilio or similar, for voice calls, SMS messaging, etc.
+* link:https://issues.apache.org/jira/browse/ISIS-1900[ISIS-1900] - [NOT A PROBLEM] Fix the release process to also generate .sha512 files
+* link:https://issues.apache.org/jira/browse/ISIS-1702[ISIS-1702] - [DUPLICATE] Infer @Programmatic on methods within @DomainService(nature=DOMAIN)
+* link:https://issues.apache.org/jira/browse/ISIS-1671[ISIS-1671] - [DUPLICATE] Upgrade to Wicket 7.8.0
+* link:https://issues.apache.org/jira/browse/ISIS-1637[ISIS-1637] - [WON'T FIX] Non-JAXB view models do not support editable properties
+* link:https://issues.apache.org/jira/browse/ISIS-1629[ISIS-1629] - [WON'T FIX] Handle dynamic visibility of list of properties rendered
+* link:https://issues.apache.org/jira/browse/ISIS-1549[ISIS-1549] - [DUPLICATE] Speed up bootstrapping by doing classpath discovery in parallel.
+* link:https://issues.apache.org/jira/browse/ISIS-1440[ISIS-1440] - [DUPLICATE] Use Fork/Join framework to load specifications in parallel? (speed up bootstrap time on multi-core machines)
+* link:https://issues.apache.org/jira/browse/ISIS-1337[ISIS-1337] - [WON'T FIX] Facet factory to automatically create UI events based on JAXB @XmlRootElement.
+* link:https://issues.apache.org/jira/browse/ISIS-1209[ISIS-1209] - [WON'T FIX] Perform static analysis of all event subscribers so that we suppress the submission of events if we know that there are no subscribers in that type of event.
+* link:https://issues.apache.org/jira/browse/ISIS-974[ISIS-974] - [WON'T FIX] Provide the ability to associate font-awesome icons with properties
+* link:https://issues.apache.org/jira/browse/ISIS-893[ISIS-893] - [WON'T FIX] (Cosmetics): If attempt to invoke non-existent action, get nasty error message
+* link:https://issues.apache.org/jira/browse/ISIS-678[ISIS-678] - [WON'T FIX] When invoke action in Wicket viewer, prefer redirect-after-post to be to a deep link.
+* link:https://issues.apache.org/jira/browse/ISIS-582[ISIS-582] - [WON'T FIX] Abstract properties are not rendered in the UI (in tables)
+* link:https://issues.apache.org/jira/browse/ISIS-1643[ISIS-1643] - [DUPLICATE] NPE on SimpleApp about
+* link:https://issues.apache.org/jira/browse/ISIS-157[ISIS-157] - [WON'T FIX] parseTextEntry fix.
+* link:https://issues.apache.org/jira/browse/ISIS-991[ISIS-991] - [WON'T FIX] Enhance Wicket viewer so that non-disabled collections can be added to / removed from.