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 2016/01/02 07:51:26 UTC

[11/13] isis git commit: ISIS-1243: updating docs for release

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_UrlEncodingService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_UrlEncodingService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_UrlEncodingService.adoc
index e96b045..d5e53df 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_UrlEncodingService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_UrlEncodingService.adoc
@@ -1,12 +1,12 @@
 [[_rgsvc_spi_UrlEncodingService]]
-= `UrlEncodingService` (`1.11.0-SNAPSHOT`)
+= `UrlEncodingService`
 :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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
 :_basedir: ../
 :_imagesdir: images/
 
 
 
-The `UrlEncodingService` (`1.11.0-SNAPSHOT`) defines a consistent way to convert strings to/from a form safe for use
+The `UrlEncodingService` defines a consistent way to convert strings to/from a form safe for use
 within a URL.  The service is used by the framework to map xref:ugbtb.adoc#_ugbtb_view-models[view model]
 mementos (derived from the state of the view model itself) into a form that can be used as a view model.  When the
 framework needs to recreate the view model (for example to invoke an action on it), this URL is converted back into a

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc b/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
index 04426c6..03342b1 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_tg_pet-clinic.adoc
@@ -62,7 +62,7 @@ Run the simpleapp archetype to build an empty Isis application:
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.10.0 \
+    -D archetypeVersion=1.11.0 \
     -D groupId=com.mycompany \
     -D artifactId=petclinic \
     -D version=1.0-SNAPSHOT \

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc b/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
index 6b7ade3..56d951f 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_tg_stop-scaffolding-start-coding.adoc
@@ -30,7 +30,7 @@ Run the simpleapp archetype to build an empty Isis application:
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.10.0 \
+    -D archetypeVersion=1.11.0 \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugbtb_i18n.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_i18n.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_i18n.adoc
index de14fe7..d24faff 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_i18n.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_i18n.adoc
@@ -9,7 +9,7 @@ Apache Isis' support for internationlization (i18n) allows every element of the
 
 It also supports translations of messages raised imperatively, by which we mean as the result of a call to `title()` to obtain an object's title, or messages resulting from any business rule violations (eg xref:rgcms.adoc#_rgcms_methods_prefixes_disable[`disable...()`] or xref:rgcms.adoc#_rgcms_methods_prefixes_validate[`validate...()`], and so on.
 
-(As of `1.11.0-SNAPSHOT`), the xref:ugvw.adoc#[Wicket viewer] (that is, its labels and messages) is also internationalized using the same mechanism.  If no translations are available, then the Wicket viewer falls back to using Wicket resource bundles.
+The xref:ugvw.adoc#[Wicket viewer] (that is, its labels and messages) is also internationalized using the same mechanism.  If no translations are available, then the Wicket viewer falls back to using Wicket resource bundles.
 
 Isis does not translate the values of your domain objects, though.  So, if you have a domain concept such as `Country` whose name is intended to be localized according to the current user, you will need to model this yourself.
 
@@ -221,9 +221,9 @@ public interface TranslatableException {
 
 
 [[_ugbtb_i18n_wicket-viewer]]
-== Wicket Viewer (`1.11.0-SNAPSHOT`)
+== Wicket Viewer
 
-(As of `1.11.0-SNAPSHOT`), the xref:ugvw.adoc#[Wicket viewer] (its labels and messages) is also internationalized using
+The xref:ugvw.adoc#[Wicket viewer] (its labels and messages) is also internationalized using
 the `TranslationService`.  This is done through an Isis-specific implementation of the Wicket framework's `org.apache.wicket.Localizer` class, namely `LocalizerForIsis`.
 
 The Wicket `Localizer` defines the following API:

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugbtb_other-techniques_overriding-jdo-annotations.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_other-techniques_overriding-jdo-annotations.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_other-techniques_overriding-jdo-annotations.adoc
index ffada22..7f23e52 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_other-techniques_overriding-jdo-annotations.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_other-techniques_overriding-jdo-annotations.adoc
@@ -43,7 +43,7 @@ This file should be placed can be placed in `src/main/java/META-INF` within your
 
 [TIP]
 ====
-(As of `1.11.0-SNAPSHOT`) you can use a mixin action on xref:rgcms.adoc#_rgcms_classes_mixins_Persistable[`Persistable`] mixin
+You can use a mixin action on xref:rgcms.adoc#_rgcms_classes_mixins_Persistable[`Persistable`] mixin
 to download the JDO class metadata in XML form.
 ====
 
@@ -58,7 +58,7 @@ For example, in writing up the above example we found that writing `schema=&quot
 
 * As of 1.9.0 Apache Isis will automatically (attempt) to create the owning schema for a given table if it does not exist. This behaviour can be customized, as described in the section on xref:_ugbtb_decoupling_db-schemas[using modules].
 
-* You may need to override the entire class metadata rather than individual elements; the mixin (`1.11.0-SNAPSHOT`) mentioned above can help here.
+* You may need to override the entire class metadata rather than individual elements; the mixin mentioned above can help here.
 ====
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_jaxb.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_jaxb.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_jaxb.adoc
index be0d561..0e72233 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_jaxb.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_jaxb.adoc
@@ -1,5 +1,5 @@
 [[_ugbtb_view-models_jaxb]]
-= JAXB-annotated DTOs (`1.11.0-SNAPSHOT`)
+= JAXB-annotated DTOs
 :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 agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
 :_basedir: ../
 :_imagesdir: images/

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_programming-model.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_programming-model.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_programming-model.adoc
index 59a62b3..11be3f0 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_programming-model.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_programming-model.adoc
@@ -69,7 +69,7 @@ public class ExcelUploadManager implements ViewModel {
 |Implement xref:rgcms.adoc#_rgcms_classes_super_ViewModel[`ViewModel`] interface.  The memento is as defined by the
 interface's methods: the programmer has full control (but also full responsibility) for the string memento.
 
-|DTO (`1.11.0-SNAPSHOT`)
+|DTO
 |
 [source,java]
 ----

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_use-cases.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_use-cases.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_use-cases.adoc
index d92e80d..319ed66 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_use-cases.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_view-models_use-cases.adoc
@@ -92,7 +92,7 @@ go).  Then, identify if there any view models that could be introduced which wou
 with the system (perhaps automating several related use cases together).
 ****
 
-== DTOs (`1.11.0-SNAPSHOT`)
+== DTOs
 
 DTOs (data transfer objects) are simple classes that (according to link:https://en.wikipedia.org/wiki/Data_transfer_object[wikipedia]) "carries data between processes".
 
@@ -107,7 +107,7 @@ In such cases, exposing domain entities over xref:ugvro.adoc#[RestfulObjects] wo
 easily changed by the producer.
 
 Instead, a view model can be defined to act as a DTO.  To put this formal contract onto a solid footing, this view
-model can (as of `1.11.0-SNAPSHOT`) simply be defined as a JAXB-annotated entity; this allows the consumer to obtain
+model can simply be defined as a JAXB-annotated entity; this allows the consumer to obtain
 the DTO in XML format along with a corresponding XSD schema describing the structure of that XML.  These XML
 representations can be surfaced by the xref:ugvro.adoc#[RestfulObjects viewer] (by implementing
 the xref:rgsvc.adoc#_rgsvc_spi_ContentMappingService[`ContentMappingService`]); the XSD can be obtained

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugbtb_web-xml.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_web-xml.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_web-xml.adoc
index ba23478..b18a2e4 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugbtb_web-xml.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugbtb_web-xml.adoc
@@ -401,8 +401,8 @@ The `IsisSessionFilter` is responsible for the (persistence) session management;
 </filter>
 ----
 <1> pluggable strategy for determining what the authentication session (credentials) are of the request
-<2> what the servlet should do if no existing session was found.  Usual values are either `unauthorized`, `basicAuthChallenge` or `auto` (`1.11.0-SNAPSHOT`).  Discussed in more detail below.
-<3> (`1.11.0-SNAPSHOT`), specify which URIs to ignore and simply passthru.  Originally introduced to allow the SwaggerSpec resource (which does not require a session) to be invoked.
+<2> what the servlet should do if no existing session was found.  Usual values are either `unauthorized`, `basicAuthChallenge` or `auto`.  Discussed in more detail below.
+<3> specify which URIs to ignore and simply passthru.  Originally introduced to allow the `SwaggerSpec` resource (which does not require a session) to be invoked.
 <4> List of paths that are allowed through even if not authenticated.  The servlets mapped to these paths are expected to be able to deal with there being no session. Typically they will be logon pages.  See below for further details.
 <5> where to redirect to if an exception occurs.
 
@@ -411,7 +411,7 @@ The `whenNoSession` parameter determines what the behaviour should be if no exis
 
 * `unauthorized` will generates a 401 response
 * `basicAuthChallenge` will also generate a 401 response, and also issues a Basic Auth challenge using `WWW-Authenticate` response header
-* `auto` (`1.11.0-SNAPSHOT`) combines the `unauthorized` and `basicAuthChallenge` strategies: it will generate a 401 response, but only issues a Basic Auth challenge if it detects that the request originates from a web browser (ie that the HTTP `Accept` header is set to `text/html`).  This means that custom Javascript apps can perform their authentication correctly, while the REST API can still be explored using the web browser (relying upon the web browser's in-built support for HTTP Basic Auth).
+* `auto` combines the `unauthorized` and `basicAuthChallenge` strategies: it will generate a 401 response, but only issues a Basic Auth challenge if it detects that the request originates from a web browser (ie that the HTTP `Accept` header is set to `text/html`).  This means that custom Javascript apps can perform their authentication correctly, while the REST API can still be explored using the web browser (relying upon the web browser's in-built support for HTTP Basic Auth).
 * `continue`, in which case the request is allowed to continue but the destination expected to know that there will be no open session
 * `restricted`, which allows access to a restricted list of URLs, otherwise will redirect to the first of that list of URLs
 

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
index 99a96d1..8d47f44 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_building-blocks.adoc
@@ -277,7 +277,7 @@ NOTE: TODO; see xref:rgcms.adoc#_rgcms_classes_domainevent[domain event] classes
 
 
 
-=== UI Events (`1.11.0-SNAPSHOT`)
+=== UI Events
 
 NOTE: TODO; see xref:rgcms.adoc#_rgcms_classes_uievent[UI event] classes.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
index 336f7fc..77342fb 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_getting-started_simpleapp-archetype.adoc
@@ -22,7 +22,7 @@ To build the app from the latest stable release, then run the following command:
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.10.0 \
+    -D archetypeVersion=1.11.0 \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \
@@ -47,7 +47,7 @@ The process is almost identical to that for stable releases, however the `archet
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.11.0-SNAPSHOT \
+    -D archetypeVersion=1.12.0-SNAPSHOT \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugsec_usage-by-isis-viewers.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugsec_usage-by-isis-viewers.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugsec_usage-by-isis-viewers.adoc
index c502fe2..ed0f10a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugsec_usage-by-isis-viewers.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugsec_usage-by-isis-viewers.adoc
@@ -122,8 +122,8 @@ The strategy is configured in `web.xml`; for example:
 </filter>
 ----
 <1> configure basic auth strategy
-<2> what to do if no session was found; we use `auto` (`1.11.0-SNAPSHOT`) so as to issue a 401 status code with basic authentication challenge if the request originated from a web browser.  (Prior to `1.11.0-SNAPSHOT` this parameter was set either to `basicAuthChallenge` (which works when requested from web browser) or to `unauthorized` (which works when requested from a suitably coded custom Javascript app).
-<3> (`1.11.0-SNAPSHOT`) which paths are allowed to be accessed directly, without a session.  The `/restful/swagger` path provides access to the SwaggerResource that dynamically generates swagger spec files from the Apache Isis metamodel.
+<2> what to do if no session was found; we use `auto` so as to issue a 401 status code with basic authentication challenge if the request originated from a web browser.  (Prior to `1.11.0` this parameter was set either to `basicAuthChallenge` (which works when requested from web browser) or to `unauthorized` (which works when requested from a suitably coded custom Javascript app).
+<3> which paths are allowed to be accessed directly, without a session.  The `/restful/swagger` path provides access to the SwaggerResource that dynamically generates swagger spec files from the Apache Isis metamodel.
 
 
 The above filter must then be chained before the servlet that actually handles the REST requests:

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc
index 4d8ef00..ea1838e 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvro_architecture.adoc
@@ -33,8 +33,7 @@ xref:rgsvc.adoc#_rgsvc_spi_ContentNegotiationService[`ContentNegotiationService`
 HTTP `Accept` header.  If the implementation does not recognize the value of the header, if can simply return `null`. +
 +
 The framework provides a number of implementations; an implementation that handles the
-xref:ugvro.adoc#_ugvro_simplified-representations[simplified representation] of the Apache Isis profile
-(`1.11.0-SNAPSHOT`); an implementation that provides support for the `x-ro-domain-type` parameter, and a
+xref:ugvro.adoc#_ugvro_simplified-representations[simplified representation] of the Apache Isis profile; an implementation that provides support for the `x-ro-domain-type` parameter, and a
 default/fallback implementation that returns the representations defined by the RO spec.
 
 * `ContentMappingService` +

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc
index 8397236..36f3318 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvro_configuration-properties.adoc
@@ -32,8 +32,7 @@ The following configuration properties are supported:
 |A mechanism for reducing the number of round-trips by eagerly rendering collections; discussed xref:ugvro.adoc#_ugvro_ro-spec_extensions_minimizing-round-trips_honor-ui-hints[here].
 
 |`isis.viewer.restfulobjects.` +
-`strictAcceptChecking` +
-(`1.11.0-SNAPSHOT`)
+`strictAcceptChecking`
 | `true`,`false` (`_false_`)
 |Whether to strictly enforce the `Accept` header checking for the default RO-spec representations (by the
 `ContentNegotiationServiceForRestfulObjectsV1_0` service). Will otherwise accept anything.  +
@@ -51,7 +50,7 @@ handful of resources that supported that profile.
 There are also a number of configuration properties that can be used to suppress or simplify the default RO-spec
 representations.
 
-These configuration properties pre-date the support, introduced in `1.11.0-SNAPSHOT`, for the Apache Isis profile, and
+These configuration properties pre-date the support, introduced in `1.11.0`, for the Apache Isis profile, and
 are limited by the fact that they are global configuration settings, so cannot be influenced on a request-by-request
 basis (as is the case with the `Accept` header used for the Apache Isis profile). They have therefore been
 deprecated, and may be removed in the future.

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
index de75ce6..c215f71 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
@@ -14,7 +14,7 @@ link:http://vitalets.github.io/angular-xeditable/[Angular XEditable],
 link:https://github.com/mgcrea/angular-strap[Angular Strap].
 
 
-As of `1.11.0-SNAPSHOT`, Apache Isis provides support for its own simplified representation for the most commonly-used
+As of `1.11.0`, Apache Isis provides support for its own simplified representation for the most commonly-used
 representations.  This is implemented using the `ContentNegotiationService` described in the
 xref:ugvro.adoc#_ugvro_architecture[architecture] chapter.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc
index 4b44713..ed762b5 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations_configuration-properties.adoc
@@ -8,7 +8,7 @@
 If all that is required is a very simple representations (of objects), you can configure the Restful Objects viewer
 to provide a simplified output, then this can be done with a number of (global) configuration properties.
 
-These configuration properties pre-date the support, introduced in `1.11.0-SNAPSHOT`, for the Apache Isis profile, and
+These configuration properties pre-date the support, introduced in `1.11.0`, for the Apache Isis profile, and
 are limited by the fact that they are global configuration settings, so cannot be influenced on a request-by-request
 basis (as is the case with the `Accept` header used for the Apache Isis profile). They have therefore been
 deprecated, and may be removed in the future.

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/rgcms.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgcms.adoc b/adocs/documentation/src/main/asciidoc/guides/rgcms.adoc
index 253c5fa..92dc334 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgcms.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgcms.adoc
@@ -14,7 +14,7 @@ reserved and prefix xref:rgcms.adoc#_rgcms_methods[methods] (such as `title()` a
 supporting xref:rgcms.adoc#_rgcms_classes[classes].
 
 It also describes the xref:rgcms.adoc#_rgcms_schema[XSD schema] defined by Apache Isis.  One use case is for the
-JAXB serialization of view models (`1.11.0-SNAPSHOT`).
+JAXB serialization of view models.
 
 === Other Guides
 

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/guides/simpleapp-archetype.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/simpleapp-archetype.adoc b/adocs/documentation/src/main/asciidoc/guides/simpleapp-archetype.adoc
index 5aa2ba1..9954b39 100644
--- a/adocs/documentation/src/main/asciidoc/guides/simpleapp-archetype.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/simpleapp-archetype.adoc
@@ -25,7 +25,7 @@ Then run the following command:
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.10.0 \
+    -D archetypeVersion=1.11.0 \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \
@@ -54,7 +54,7 @@ The process is almost identical to that for stable releases, however the `archet
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.11.0-SNAPSHOT \
+    -D archetypeVersion=1.12.0-SNAPSHOT \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/index.html
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/index.html b/adocs/documentation/src/main/asciidoc/index.html
index f7b0ffb..c6f0ca8 100644
--- a/adocs/documentation/src/main/asciidoc/index.html
+++ b/adocs/documentation/src/main/asciidoc/index.html
@@ -664,7 +664,7 @@
 mvn archetype:generate  \
     -D archetypeGroupId=org.apache.isis.archetype \
     -D archetypeArtifactId=simpleapp-archetype \
-    -D archetypeVersion=1.10.0 \
+    -D archetypeVersion=1.11.0 \
     -D groupId=com.mycompany \
     -D artifactId=myapp \
     -D version=1.0-SNAPSHOT \

http://git-wip-us.apache.org/repos/asf/isis/blob/0f92613e/adocs/documentation/src/main/asciidoc/release-notes.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/release-notes.adoc b/adocs/documentation/src/main/asciidoc/release-notes.adoc
index 3d2f0ca..5a543f1 100644
--- a/adocs/documentation/src/main/asciidoc/release-notes.adoc
+++ b/adocs/documentation/src/main/asciidoc/release-notes.adoc
@@ -22,7 +22,7 @@ This table summarises all releases of Apache Isis to date.
 | Bugs
 
 | xref:r1.11.0[1.11.0]
-| xx-xxx-20xx
+| 02-jan-2016
 | * https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12311171&version=12333974[1.11.0]
 | Combined release notes for core and simpleapp-archetype.
 | 9
@@ -210,6 +210,7 @@ This table summarises all releases of Apache Isis to date.
 
 
 
+include::_release-notes_1.11.0.adoc[leveloffset=+1]
 include::_release-notes_1.10.0.adoc[leveloffset=+1]
 include::_release-notes_1.9.0.adoc[leveloffset=+1]
 include::_release-notes_1.8.0.adoc[leveloffset=+1]