http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel.adoc
index 000586c..65becc2 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel.adoc
@@ -33,9 +33,9 @@ Note that there is a 
`DomainObjectContainer#newViewModelInstance(.)`; this is fo
 ====
 
 
-The view model's memento will be derived from the value of the view model 
object's properties. Any 
xref:rgant.adoc#_rgant-Property_notPersisted[`@Property#notPersisted()`] 
properties will be excluded from the memento, as will any 
xref:rgant.adoc#_rgant-Programmatic[`@Programmatic`] properties. Properties 
that are merely xref:rgant.adoc#_rgant-Property_hidden[hidden] _are_ included 
in the memento.
+The view model's memento will be derived from the value of the view model 
object's properties. Any 
xref:../rgant/rgant.adoc#_rgant-Property_notPersisted[`@Property#notPersisted()`]
 properties will be excluded from the memento, as will any 
xref:../rgant/rgant.adoc#_rgant-Programmatic[`@Programmatic`] properties. 
Properties that are merely 
xref:../rgant/rgant.adoc#_rgant-Property_hidden[hidden] _are_ included in the 
memento.
 
-Only properties supported by the configured 
xref:rgsvc.adoc#_rgsvc_api_MementoService[`MementoService`] can be used. The 
default implementation supports all the value types and persisted entities.
+Only properties supported by the configured 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_MementoService[`MementoService`] can be 
used. The default implementation supports all the value types and persisted 
entities.
 
 (As of 1.8.0) there are some limitations:
 * view models cannot hold collections other view models (simple properties 
_are_ supported, though)
@@ -44,7 +44,7 @@ Only properties supported by the configured 
xref:rgsvc.adoc#_rgsvc_api_MementoSe
 
 [WARNING]
 ====
-The `@ViewModel` does not allow the objectType to be specified, meaning that 
it is incompatible with the metamodel validation check ennabled by the 
xref:rgcfg.adoc#__rgcfg_configuring-core_metamodel-validation[`explicitObjectType`]
 configuration property.
+The `@ViewModel` does not allow the objectType to be specified, meaning that 
it is incompatible with the metamodel validation check ennabled by the 
xref:../rgcfg/rgcfg.adoc#__rgcfg_configuring-core_metamodel-validation[`explicitObjectType`]
 configuration property.
 
-Instead, use 
xref:rgant.adoc#_rgant_DomainObject_nature[`@DomainObject#nature()`] with 
`Nature.VIEW_MODEL`, and specify 
xref:rgant.adoc#_rgant_DomainObject_objectType[`@DomainObject#objectType()`].
+Instead, use 
xref:../rgant/rgant.adoc#_rgant_DomainObject_nature[`@DomainObject#nature()`] 
with `Nature.VIEW_MODEL`, and specify 
xref:../rgant/rgant.adoc#_rgant_DomainObject_objectType[`@DomainObject#objectType()`].
 ====

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout.adoc
index 8328c21..21f16ac 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout.adoc
@@ -5,8 +5,8 @@
 :_imagesdir: images/
 
 
-The `@ViewModelLayout` annotation is identical to the 
xref:rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`], but is 
provided
-for symmetry with domain objects that have been annotated using 
xref:rgant.adoc#_rgant-ViewModel[`@ViewModel`] (rather than 
xref:rgant.adoc#_rgant-DomainObject_nature[`@DomainObject(nature=VIEW_MODEL)`]).
+The `@ViewModelLayout` annotation is identical to the 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`], but 
is provided
+for symmetry with domain objects that have been annotated using 
xref:../rgant/rgant.adoc#_rgant-ViewModel[`@ViewModel`] (rather than 
xref:../rgant/rgant.adoc#_rgant-DomainObject_nature[`@DomainObject(nature=VIEW_MODEL)`]).
 
 
 The table below summarizes the annotation's attributes.
@@ -20,12 +20,12 @@ The table below summarizes the annotation's attributes.
 | Description
 
 
-|xref:rgant.adoc#_rgant-ViewModelLayout_cssclass[`cssClass()`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_cssclass[`cssClass()`]
 |Any string valid as a CSS class
-|the css class that a domain class (type) should have, to allow more targetted 
styling in 
xref:rgcfg.adoc#_rgcfg_application-specific_application-css[`application.css`]
+|the css class that a domain class (type) should have, to allow more targetted 
styling in 
xref:../rgcfg/rgcfg.adoc#_rgcfg_application-specific_application-css[`application.css`]
 
 
-|xref:rgant.adoc#_rgant-ViewModelLayout_cssClassFa[`cssClassFa()`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_cssClassFa[`cssClassFa()`]
 |Any valid link:http://fortawesome.github.io/Font-Awesome/[Font awesome] icon 
name
 |specify a font awesome icon for the action's menu link or icon. +
 
@@ -36,25 +36,25 @@ The table below summarizes the annotation's attributes.
 |Currently unused.
 
 
-|xref:rgant.adoc#_rgant-ViewModelLayout_describedAs[`describedAs()`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_describedAs[`describedAs()`]
 |String.
 |description of this class, eg to be rendered in a tooltip.
 
 
 
-|xref:rgant.adoc#_rgant-ViewModelLayout_named[`named()`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_named[`named()`]
 |String.
 |to override the name inferred from the action's name in code. +
 
 A typical use case is if the desired name is a reserved Java keyword, such as 
`default` or `package`.
 
 
-|xref:rgant.adoc#_rgant-ViewModelLayout_paged[`paged()`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_paged[`paged()`]
 |Positive integer
 |the page size for instances of this class when rendered within a table (as 
returned from an action invocation)
 
 
-|xref:rgant.adoc#_rgant-ViewModelLayout_plural[`plural()`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_plural[`plural()`]
 |String.
 |the plural name of the class
 
@@ -77,7 +77,7 @@ For example:
 )
 public class CategoryPieChart { ... }
 ----
-<1> this annotation is intended for use with `@ViewModel`.  If a view model 
has been specified using the equivalent 
xref:rgant.adoc#_rgant-DomainObject_nature[`@DomainObject(nature=Nature.VIEW_MODEL)`],
 then we recommend you use 
xref:rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`] instead.
+<1> this annotation is intended for use with `@ViewModel`.  If a view model 
has been specified using the equivalent 
xref:../rgant/rgant.adoc#_rgant-DomainObject_nature[`@DomainObject(nature=Nature.VIEW_MODEL)`],
 then we recommend you use 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`] 
instead.
 
 
 [NOTE]

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClass.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClass.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClass.adoc
index 0bd9bee..167d28e 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClass.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClass.adoc
@@ -6,9 +6,9 @@
 
 
 
-The `cssClass()` attribute can be used to render additional CSS classes in the 
HTML (a wrapping `<div>`) that represents the view model.   
xref:rgcfg.adoc#_rgcfg_application-specific_application-css[Application-specific
 CSS] can then be used to target and adjust the UI representation of that 
particular element.
+The `cssClass()` attribute can be used to render additional CSS classes in the 
HTML (a wrapping `<div>`) that represents the view model.   
xref:../rgcfg/rgcfg.adoc#_rgcfg_application-specific_application-css[Application-specific
 CSS] can then be used to target and adjust the UI representation of that 
particular element.
 
-This attribute can also be applied to 
xref:rgant.adoc#_rgant-DomainObjectLayout_cssClass[domain objects], 
xref:rgant.adoc#_rgant-ActionLayout_cssClass[actions] 
xref:rgant.adoc#_rgant-PropertyLayout_cssClass[properties],  
xref:rgant.adoc#_rgant-CollectionLayout_cssClass[collections] and 
xref:rgant.adoc#_rgant-ParameterLayout_cssClass[parameters].
+This attribute can also be applied to 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_cssClass[domain objects], 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_cssClass[actions] 
xref:../rgant/rgant.adoc#_rgant-PropertyLayout_cssClass[properties],  
xref:../rgant/rgant.adoc#_rgant-CollectionLayout_cssClass[collections] and 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_cssClass[parameters].
 
 
 For example:
@@ -25,6 +25,6 @@ public class CategoryPieChart { ... }
 
 [NOTE]
 ====
-The similar 
xref:rgant.adoc#_rgant-ViewModelLayout_cssClassFa[`@ViewModelLayout#cssClassFa()`]
 annotation attribute is also used as a hint to apply CSS, but in particular to 
allow http://fortawesome.github.io/Font-Awesome/icons/[Font Awesome icons] to 
be rendered as the icon for classes.
+The similar 
xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_cssClassFa[`@ViewModelLayout#cssClassFa()`]
 annotation attribute is also used as a hint to apply CSS, but in particular to 
allow http://fortawesome.github.io/Font-Awesome/icons/[Font Awesome icons] to 
be rendered as the icon for classes.
 ====
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClassFa.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClassFa.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClassFa.adoc
index b93ffd7..e42d659 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClassFa.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_cssClassFa.adoc
@@ -9,10 +9,10 @@
 
 The `cssClassFa()` attribute is used to specify the name of a 
link:http://fortawesome.github.io/Font-Awesome/icons/[Font Awesome icon] name, 
to be rendered as the domain object's icon.
 
-These attribute can also be applied to 
xref:rgant.adoc#_rgant-DomainObjectLayout_cssClassFa[domain objects] to specify 
the object's icon, and to 
xref:rgant.adoc#_rgant-ActionLayout_cssClassFa[actions] to specify an icon for 
the action's representation as a button or menu item.
+These attribute can also be applied to 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_cssClassFa[domain objects] 
to specify the object's icon, and to 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_cssClassFa[actions] to specify an 
icon for the action's representation as a button or menu item.
 
 
-If necessary the icon specified can be overridden by a particular object 
instance using the 
xref:rgcms.adoc#_rgcms_methods_reserved_iconName[`iconName()`] method.
+If necessary the icon specified can be overridden by a particular object 
instance using the 
xref:../rgcms/rgcms.adoc#_rgcms_methods_reserved_iconName[`iconName()`] method.
 
 
 
@@ -36,6 +36,6 @@ The related `cssClassFaPosition()` attribute is currently 
unused for domain obje
 
 [NOTE]
 ====
-The similar 
xref:rgant.adoc#_rgant-ViewModelLayout_cssClass[`@ViewModelLayout#cssClass()`] 
annotation attribute is also used as a hint to apply CSS, but for wrapping the 
representation of an object or object member so that it can be styled in an 
application-specific way.
+The similar 
xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_cssClass[`@ViewModelLayout#cssClass()`]
 annotation attribute is also used as a hint to apply CSS, but for wrapping the 
representation of an object or object member so that it can be styled in an 
application-specific way.
 ====
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_describedAs.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_describedAs.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_describedAs.adoc
index 355f00a..1646f4e 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_describedAs.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_describedAs.adoc
@@ -5,7 +5,7 @@
 :_imagesdir: images/
 
 
-The `describedAs()` attribute is used to provide a short description of the 
view model to the user.  In the xref:ugvw.adoc#[Wicket viewer] it is displayed 
as a 'tool tip'.  The `describedAs()` attribute can also be specified for 
xref:rgant.adoc#_rgant-CollectionLayout_describedAs[collections],  
xref:rgant.adoc#_rgant-PropertyLayout_describedAs[properties], 
xref:rgant.adoc#_rgant-ActionLayout_describedAs[actions], 
xref:rgant.adoc#_rgant-ParameterLayout_describedAs[parameters] and 
xref:rgant.adoc#_rgant-DomainObjectLayout_describedAs[domain objects].
+The `describedAs()` attribute is used to provide a short description of the 
view model to the user.  In the xref:ugvw.adoc#[Wicket viewer] it is displayed 
as a 'tool tip'.  The `describedAs()` attribute can also be specified for 
xref:../rgant/rgant.adoc#_rgant-CollectionLayout_describedAs[collections],  
xref:../rgant/rgant.adoc#_rgant-PropertyLayout_describedAs[properties], 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_describedAs[actions], 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_describedAs[parameters] and 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_describedAs[domain objects].
 
 For example:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_named.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_named.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_named.adoc
index 08bc797..2998e40 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_named.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_named.adoc
@@ -5,7 +5,7 @@
 :_imagesdir: images/
 
 
-The `named()` attribute explicitly specifies the view model's name, overriding 
the name that would normally be inferred from the Java source code.  This 
attribute can also be specified for 
xref:rgant.adoc#_rgant-ActionLayout_named[actions], 
xref:rgant.adoc#_rgant-CollectionLayout_named[collections], 
xref:rgant.adoc#_rgant-PropertyLayout_named[properties], 
xref:rgant.adoc#_rgant-ParameterLayout_named[parameters], 
xref:rgant.adoc#_rgant-DomainObjectLayout_named[domain objects] and 
xref:rgant.adoc#_rgant-DomainServiceLayout_named[domain services].
+The `named()` attribute explicitly specifies the view model's name, overriding 
the name that would normally be inferred from the Java source code.  This 
attribute can also be specified for 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_named[actions], 
xref:../rgant/rgant.adoc#_rgant-CollectionLayout_named[collections], 
xref:../rgant/rgant.adoc#_rgant-PropertyLayout_named[properties], 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_named[parameters], 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_named[domain objects] and 
xref:../rgant/rgant.adoc#_rgant-DomainServiceLayout_named[domain services].
 
 [TIP]
 ====

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_paged.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_paged.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_paged.adoc
index f06356d..6ba7e74 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_paged.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_paged.adoc
@@ -5,7 +5,7 @@
 :_imagesdir: images/
 
 
-The `paged()` attribute specifies the number of rows to display in a 
standalone collection, as returned from an action invocation.  This attribute 
can also be applied to 
xref:rgant.adoc#_rgant-CollectionLayout_paged[collections] and 
xref:rgant.adoc#_rgant-DomainObjectLayout_paged[domain objects].
+The `paged()` attribute specifies the number of rows to display in a 
standalone collection, as returned from an action invocation.  This attribute 
can also be applied to 
xref:../rgant/rgant.adoc#_rgant-CollectionLayout_paged[collections] and 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_paged[domain objects].
 
 
 
@@ -29,6 +29,6 @@ public class OrderAnalysis {
 ----
 
 
-It is also possible to specify a global default for the page size of 
standalone collections, using the 
xref:rgcfg.adoc#_rgcfg_configuring-core[configuration property] 
`isis.viewer.paged.standalone`.
+It is also possible to specify a global default for the page size of 
standalone collections, using the 
xref:../rgcfg/rgcfg.adoc#_rgcfg_configuring-core[configuration property] 
`isis.viewer.paged.standalone`.
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_plural.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_plural.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_plural.adoc
index 4cc2180..e178f51 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_plural.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModelLayout_plural.adoc
@@ -10,7 +10,7 @@ When Apache Isis displays a standalone collection of several 
objects, it will la
 
 By default the plural name will be derived from the end of the singular name, 
with support for some basic English language defaults (eg using "ies" for names 
ending with a "y").
 
-The `plural()` attribute allows the plural form of the class name to be 
specified explicitly.  This attribute is also supported for 
xref:rgant.adoc#_rgant-DomainObjectLayout_plural[domain objects].
+The `plural()` attribute allows the plural form of the class name to be 
specified explicitly.  This attribute is also supported for 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_plural[domain objects].
 
 For example:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel_objectType.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel_objectType.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel_objectType.adoc
index bdd4008..1ed0889 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel_objectType.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-ViewModel_objectType.adoc
@@ -11,12 +11,12 @@ This value is used internally to generate a string 
representation of an objects
 This can appear in several contexts, including:
 
 * as the value of `Bookmark#getObjectType()` and in the `toString()` value of 
`Bookmark`
- (see xref:rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`])
+ (see xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`])
  ** and thus in the "table-of-two-halves" pattern, as per (non-ASF) 
http://github.com/isisaddons/isis-module-poly[Isis addons' poly] module
-* in the serialization of `OidDto` in the 
xref:rgcms.adoc#_rgcms_schema-cmd[command] and 
xref:rgcms.adoc#_rgcms_schema-ixn[interaction] schemas
+* in the serialization of `OidDto` in the 
xref:../rgcms/rgcms.adoc#_rgcms_schema-cmd[command] and 
xref:../rgcms/rgcms.adoc#_rgcms_schema-ixn[interaction] schemas
 * in the URLs of the xref:ugvro.adoc#[RestfulObjects viewer]
 * in the URLs of the xref:ugvw.adoc#[Wicket viewer] (in general and in 
particular if xref:ugvw.adoc#_ugvw_features_hints-and-copy-url[copying URLs])
-* in XML snapshots generated by the 
xref:rgsvc.adoc#_rgsvc_api_XmlSnapshotService[`XmlSnapshotService`]
+* in XML snapshots generated by the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_XmlSnapshotService[`XmlSnapshotService`]
 
 
 
@@ -39,9 +39,9 @@ public class Order {
 
 The rules of precedence are:
 
-1. xref:rgant.adoc#_rgant_Discriminator[`@Discriminator`]
-2. `@DomainObject#objectType`, or 
xref:rgant.adoc#_rgant_ViewModel_objectType[`@ViewModel#objectType()`], or 
xref:rgant.adoc#_rgant_aaa_deprecated[`@ObjectType`] (deprecated)
-3. xref:rgant.adoc#_rgant_PersistenceCapable[`@PersistenceCapable`], if at 
least the `schema` attribute is defined.  +
+1. xref:../rgant/rgant.adoc#_rgant_Discriminator[`@Discriminator`]
+2. `@DomainObject#objectType`, or 
xref:../rgant/rgant.adoc#_rgant_ViewModel_objectType[`@ViewModel#objectType()`],
 or xref:../rgant/rgant.adoc#_rgant_aaa_deprecated[`@ObjectType`] (deprecated)
+3. xref:../rgant/rgant.adoc#_rgant_PersistenceCapable[`@PersistenceCapable`], 
if at least the `schema` attribute is defined.  +
 +
 If both `schema` and `table` are defined, then the value is "`schema.table`".
 If only `schema` is defined, then the value is "`schema.className`".

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlJavaTypeAdapter.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlJavaTypeAdapter.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlJavaTypeAdapter.adoc
index 02cb8ef..2b2a034 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlJavaTypeAdapter.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlJavaTypeAdapter.adoc
@@ -8,7 +8,7 @@
 The JAXB `@XmlJavaTypeAdapter` annotation is used with the framework-provided
 `PersistentEntityAdapter` to instruct JAXB to serialize references to 
persistent entities using the canonical
 `OidDto` complex type: the object's type and its identifier.  This is the 
formal XML equivalent to the `Bookmark`
-provided by the xref:rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`].
+provided by the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`].
 
 For example:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlRootElement.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlRootElement.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlRootElement.adoc
index 815cac8..ac3b58d 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlRootElement.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant-XmlRootElement.adoc
@@ -13,13 +13,13 @@ A view model is a non-persisted domain object whose state 
is converted to/from a
 JAXB-annotated object this memento is its XML representation.  JAXB generally 
requires that the root element of the
 XML representation is annotated with `@XmlRootElement`.  Apache Isis makes 
this a mandatory requirement.
 
-In comparison to using either the 
xref:rgcms.adoc#_rgcms_classes_super_ViewModel[`ViewModel`] interface or the
-xref:rgant.adoc#_rgant-ViewModel[`@ViewModel`] annotation, using 
`@XmlRootElement` has a couple of
+In comparison to using either the 
xref:../rgcms/rgcms.adoc#_rgcms_classes_super_ViewModel[`ViewModel`] interface 
or the
+xref:../rgant/rgant.adoc#_rgant-ViewModel[`@ViewModel`] annotation, using 
`@XmlRootElement` has a couple of
 significant advantages:
 
 * the view model can be used as a "canonical" DTO, for example when accessing 
data using the
 xref:ugvro.adoc#[RestfulObjects viewer] in combination with the
-xref:rgsvc.adoc#_rgsvc_spi_ContentMappingService[`ContentMappingService`]. +
+xref:../rgsvc/rgsvc.adoc#_rgsvc_spi_ContentMappingService[`ContentMappingService`].
 +
 +
 This provides a stable and
 versioned API to access data in XML format using whatever client-side 
technology may be appropriate.
@@ -31,15 +31,15 @@ If using `ViewModel` interface then arbitrary state 
(including that of collectio
 all the code by hand
 
 The main disadvantages of using JAXB-annotated view models is that any 
referenced persistent entity must be annotated
-with the xref:rgant.adoc#_rgant-XmlJavaTypeAdapter[`@XmlJavaTypeAdapter`], 
using the
+with the 
xref:../rgant/rgant.adoc#_rgant-XmlJavaTypeAdapter[`@XmlJavaTypeAdapter`], 
using the
 framework-provided `PersistentEntityAdapter`.  This adapter converts any 
references to such domain entities using the
-`oidDto` complex type (as defined by the Apache Isis 
xref:rgcms.adoc#_rgcms_schema-common[common schema]):
+`oidDto` complex type (as defined by the Apache Isis 
xref:../rgcms/rgcms.adoc#_rgcms_schema-common[common schema]):
 the object's type and its identifier.
 
 [TIP]
 ====
 The memento string for view models is converted into a form compatible with 
use within a URL.  This is performed by the
-xref:rgsvc.adoc#_rgsvc_spi_UrlEncodingService[`UrlEncodingService`], the 
default implementation of which
+xref:../rgsvc/rgsvc.adoc#_rgsvc_spi_UrlEncodingService[`UrlEncodingService`], 
the default implementation of which
 simply encodes to base 64.  If the view model XML graph is too large to be 
serialized to a string, then an alternative
 implementation (eg which maps XML strings to a GUID, say) can be configured 
using the technique described in
 xref:rg.adoc#_ugfun_how-tos_replacing-default-service-implementations[here] in 
the user guide.
@@ -75,7 +75,7 @@ Although (like any other viewmodel) a JAXB-annotated can have 
behaviour (actions
 the DTO "clean", just focused on specifying the data contract.
 
 Behaviour can therefore be provided using 
xref:ugbtb.adoc#_ugbtb_decoupling_mixins[mixins] (annotated with
-xref:rgant.adoc#_rgant-Mixin[`@Mixin`]), while 
xref:rgcms.adoc#_rgcms_classes_uievent[UI events] can be used
+xref:../rgant/rgant.adoc#_rgant-Mixin[`@Mixin`]), while 
xref:../rgcms/rgcms.adoc#_rgcms_classes_uievent[UI events] can be used
 to obtain title, icons and so on.
 
 For a more complete discussion of writing JAXB view models/DTOs, see 
xref:ugbtb.adoc#_ugbtb_view-models[this topic]

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_deprecated.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_deprecated.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_deprecated.adoc
index 47a93d7..d04be91 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_deprecated.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_deprecated.adoc
@@ -8,7 +8,7 @@
 As Apache Isis has evolved and grown, we found ourselves adding more and more 
annotations; but most of these related to either an object type (entity, view 
model, service) or an object member (property, collection, action).
 Over time it became harder and harder for end programmers to discover these 
new features.
 
-Accordingly, (in v1.8.0) we decided to unify the semantics into the main 
(core) annotations listed xref:rgant.adoc#_rgant-aaa_main[above].
+Accordingly, (in v1.8.0) we decided to unify the semantics into the main 
(core) annotations listed xref:../rgant/rgant.adoc#_rgant-aaa_main[above].
 
 The annotations listed in the table below are still supported by Apache Isis, 
but will be retired in Apache Isis v2.0.
 
@@ -24,126 +24,126 @@ The annotations listed in the table below are still 
supported by Apache Isis, bu
 
 |`@ActionOrder`
 |Order of buttons and menu items representing actions.
-|xref:rgant.adoc#_rgant-MemberOrder[`@MemberOrder`]
+|xref:../rgant/rgant.adoc#_rgant-MemberOrder[`@MemberOrder`]
 |UI
 |Yes
 
 |`@ActionInteraction`
 |Enable subscribers on the Event Bus Service to either veto, validate or take 
further steps before/after an action has been invoked.
-|xref:rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`]
 |Domain
 |
 
 |`@ActionSemantics`
 |Query-only, idempotent or non-idempotent.
-|xref:rgant.adoc#_rgant-Action_semantics[`@Action#semantics()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_semantics[`@Action#semantics()`]
 |Domain
 |
 
 |`@Audited`
 |Audit changes to an object.
-|xref:rgant.adoc#_rgant-DomainObject_auditing[`@DomainObject#` +
+|xref:../rgant/rgant.adoc#_rgant-DomainObject_auditing[`@DomainObject#` +
 `auditing()`]
 |Domain
 |
 
 |`@AutoComplete`
 |Repository method to search for entities
-|xref:rgant.adoc#_rgant-DomainObject_autoCompleteRepository[`@DomainObject` +
+|xref:../rgant/rgant.adoc#_rgant-DomainObject_autoCompleteRepository[`@DomainObject`
 +
 `#autoCompleteRepository()`]
 |UI/Domain
 |
 
 |`@Bookmarkable`
 |Whether (and how) to create a bookmark for visited object.
-|xref:rgant.adoc#_rgant-DomainObjectLayout_bookmarking[`@DomainObjectLayout` +
+|xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_bookmarking[`@DomainObjectLayout`
 +
 `#bookmarking()`]
 |UI
 |
 
 |`@Bounded`
 |Bounded (and limited) number of instances of an entity type, translates into 
a drop-down for any property of that type.
-|xref:rgant.adoc#_rgant-DomainObject_bounded[`@DomainObject#bounded()`]
+|xref:../rgant/rgant.adoc#_rgant-DomainObject_bounded[`@DomainObject#bounded()`]
 |Domain
 |
 
 |`@Bulk`
 |Indicates an action is a bulk action, can be applied to multiple instances.
-|xref:rgant.adoc#_rgant-Action_invokeOn[`@Action#invokeOn()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_invokeOn[`@Action#invokeOn()`]
 |UI, Domain
 |
 
 |`@CollectionInteraction`
 |Enable subscribers on the Event Bus Service to either veto, validate or take 
further steps before/after a collection has been added to or removed from.
-|xref:rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`]
+|xref:../rgant/rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`]
 |Domain
 |
 
 |`@Command`
 |Action invocation should be reified as a command object, optionally 
persistable for profiling and enhanced auditing, and background/async support.
-|xref:rgant.adoc#_rgant-Action_command[`@Action#command()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_command[`@Action#command()`]
 |Domain
 |
 
 |`@CssClass`
 |Allow visual representation of individual objects or object members layout to 
be customized by application-specific CSS.
-|`#cssClass()` attribute for: 
xref:rgant.adoc#_rgant-DomainObjectLayout_cssClass[`@DomainObjectLayout`], 
xref:rgant.adoc#_rgant-PropertyLayout_cssClass[`@PropertyLayout`],  
xref:rgant.adoc#_rgant-CollectionLayout_cssClass[`@CollectionLayout`], 
xref:rgant.adoc#_rgant-ActionLayout_cssClass[`@ActionLayout`] and 
xref:rgant.adoc#_rgant-ParameterLayout_cssClass[`@ParameterLayout`]
+|`#cssClass()` attribute for: 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_cssClass[`@DomainObjectLayout`],
 xref:../rgant/rgant.adoc#_rgant-PropertyLayout_cssClass[`@PropertyLayout`],  
xref:../rgant/rgant.adoc#_rgant-CollectionLayout_cssClass[`@CollectionLayout`], 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_cssClass[`@ActionLayout`] and 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_cssClass[`@ParameterLayout`]
 |UI
 |Yes
 
 |`@CssClassFa`
 |So that font awesome icons can be applied to action buttons/menu items and 
optionally as an object icon.
-|`cssClassFa()` attribute for: 
xref:rgant.adoc#_rgant-ActionLayout_cssClassFa[`@ActionLayout`], 
xref:rgant.adoc#_rgant-DomainObjectLayout_cssClassFa[`DomainObjectLayout`] and 
xref:rgant.adoc#_rgant-ViewModelLayout_cssClassFa[`ViewModelLayout`]
+|`cssClassFa()` attribute for: 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_cssClassFa[`@ActionLayout`], 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_cssClassFa[`DomainObjectLayout`]
 and 
xref:../rgant/rgant.adoc#_rgant-ViewModelLayout_cssClassFa[`ViewModelLayout`]
 |UI
 |Yes
 
 |`@Debug`
 |Action only invokable in debug mode.
-|Not supported by either the xref:ugvw.adoc#[Wicket viewer] or the 
xref:ugvro.adoc#[RestfulObjects viewer]; use prototype mode instead 
(xref:rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`])
+|Not supported by either the xref:ugvw.adoc#[Wicket viewer] or the 
xref:ugvro.adoc#[RestfulObjects viewer]; use prototype mode instead 
(xref:../rgant/rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`])
 |UI
 |
 
 |`@DescribedAs`
 |Provide a longer description/tool-tip of an object or object member.
-|`#describedAs()` attribute for 
xref:rgant.adoc#_rgant-DomainObject_describedAs[`@DomainObjectLayout`], 
xref:rgant.adoc#_rgant-PropertyLayout_describedAs[`@PropertyLayout`], 
xref:rgant.adoc#_rgant-CollectionLayout_describedAs[`@CollectionLayout`], 
xref:rgant.adoc#_rgant-ActionLayout_describedAs[`@ActionLayout`] and 
xref:rgant.adoc#_rgant-ParameterLayout_describedAs[`@ParameterLayout`]
+|`#describedAs()` attribute for 
xref:../rgant/rgant.adoc#_rgant-DomainObject_describedAs[`@DomainObjectLayout`],
 xref:../rgant/rgant.adoc#_rgant-PropertyLayout_describedAs[`@PropertyLayout`], 
xref:../rgant/rgant.adoc#_rgant-CollectionLayout_describedAs[`@CollectionLayout`],
 xref:../rgant/rgant.adoc#_rgant-ActionLayout_describedAs[`@ActionLayout`] and 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_describedAs[`@ParameterLayout`]
 |UI
 |Yes
 
 |`@Disabled`
 |Object property cannot be edited, an object collection cannot be added 
to/removed from, or an object action cannot be invoked.
-|`#editing()` attribute for 
xref:rgant.adoc#_rgant-Property_editing[`@Property`],  
xref:rgant.adoc#_rgant-Collection_editing[`@Collection`] and 
xref:rgant.adoc#_rgant-DomainObject_editing[`@DomainObject`]
+|`#editing()` attribute for 
xref:../rgant/rgant.adoc#_rgant-Property_editing[`@Property`],  
xref:../rgant/rgant.adoc#_rgant-Collection_editing[`@Collection`] and 
xref:../rgant/rgant.adoc#_rgant-DomainObject_editing[`@DomainObject`]
 |UI, Domain
 |Yes
 
 |`@Exploration`
 |Action available in special 'exploration' mode.
-|Not supported by either the xref:ugvw.adoc#[Wicket viewer] or the 
xref:ugvro.adoc#[RestfulObjects viewer]; use prototype mode instead 
(xref:rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`])
+|Not supported by either the xref:ugvw.adoc#[Wicket viewer] or the 
xref:ugvro.adoc#[RestfulObjects viewer]; use prototype mode instead 
(xref:../rgant/rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`])
 |UI
 |
 
 |`@FieldOrder`
 |Order of properties and collections.
-|xref:rgant.adoc#_rgant-MemberOrder[`@MemberOrder`]
+|xref:../rgant/rgant.adoc#_rgant-MemberOrder[`@MemberOrder`]
 |UI
 |Yes
 
 |`@Hidden`
 |Object member is not visible, or on domain service (to indicate that none of 
its actions are visible).
-|For domain object members, use `#hidden()` attribute of 
xref:rgant.adoc#_rgant-Action_hidden[`Action`], 
xref:rgant.adoc#_rgant-Property_hidden[`Property`] or 
xref:rgant.adoc#_rgant-Collection_hidden[`Collection`].  +
-For domain service, use 
xref:rgant.adoc#_rgant-DomainService_nature[`@DomainService(` +
+|For domain object members, use `#hidden()` attribute of 
xref:../rgant/rgant.adoc#_rgant-Action_hidden[`Action`], 
xref:../rgant/rgant.adoc#_rgant-Property_hidden[`Property`] or 
xref:../rgant/rgant.adoc#_rgant-Collection_hidden[`Collection`].  +
+For domain service, use 
xref:../rgant/rgant.adoc#_rgant-DomainService_nature[`@DomainService(` +
 `nature=DOMAIN)`]
 |UI, Domain
 |Yes
 
 |`@Idempotent`
 |Whether an action is idempotent (can be invoked multiple times with same 
post-condition).
-|xref:rgant.adoc#_rgant-Action_semantics[`@Action#semantics`]
+|xref:../rgant/rgant.adoc#_rgant-Action_semantics[`@Action#semantics`]
 |Domain
 |
 
 |`@Ignore`
 |Exclude this method from the metamodel.
-|xref:rgant.adoc#_rgant-Programmatic[`@Programmatic`]. +
+|xref:../rgant/rgant.adoc#_rgant-Programmatic[`@Programmatic`]. +
 
 `@Ignore` was deprecated because it can easily clash with `@org.junit.Ignore`.
 |Domain
@@ -152,7 +152,7 @@ For domain service, use 
xref:rgant.adoc#_rgant-DomainService_nature[`@DomainServ
 |`@Immutable`
 |An object's state cannot be changed (properties cannot be edited, collections 
cannot be added to or removed from).
 Actions can still be invoked.
-|xref:rgant.adoc#_rgant-DomainObject_editing[`@DomainObject#editing()`]
+|xref:../rgant/rgant.adoc#_rgant-DomainObject_editing[`@DomainObject#editing()`]
 |Domain
 |
 
@@ -164,7 +164,7 @@ Actions can still be invoked.
 
 |`@MaxLength`
 |Maximum length of a property value (strings).
-|`#maxLength()` attribute for 
xref:rgant.adoc#_rgant-Property_maxLength[`@Property`] or 
xref:rgant.adoc#_rgant-Parameter_maxLength[`@Parameter`]
+|`#maxLength()` attribute for 
xref:../rgant/rgant.adoc#_rgant-Property_maxLength[`@Property`] or 
xref:../rgant/rgant.adoc#_rgant-Parameter_maxLength[`@Parameter`]
 |Domain
 |
 
@@ -183,65 +183,65 @@ Actions can still be invoked.
 
 |`@MultiLine`
 |Render string property over multiple lines (a textarea rather than a textbox).
-|`#multiLine()` attribute for 
xref:rgant.adoc#_rgant-Property_multiLine[`@Property`] or 
xref:rgant.adoc#_rgant-Parameter_multiLine[`@Parameter`]
+|`#multiLine()` attribute for 
xref:../rgant/rgant.adoc#_rgant-Property_multiLine[`@Property`] or 
xref:../rgant/rgant.adoc#_rgant-Parameter_multiLine[`@Parameter`]
 |UI
 |Yes
 
 |`@MustSatisfy`
 |Specify arbitrary specification constraints on a property or action parameter.
-|`#mustSatisfy()` attribute for 
xref:rgant.adoc#_rgant-Property_mustSatisfy[`@Property`] or 
xref:rgant.adoc#_rgant-Parameter_mustSatisfy[`@Parameter`]
+|`#mustSatisfy()` attribute for 
xref:../rgant/rgant.adoc#_rgant-Property_mustSatisfy[`@Property`] or 
xref:../rgant/rgant.adoc#_rgant-Parameter_mustSatisfy[`@Parameter`]
 |Domain
 |
 
 |`@Named`
 |Override name inferred from class. Required for parameter names (prior to 
Java8).
-|`#named()` attribute for 
xref:rgant.adoc#_rgant-DomainServiceLayout_named[`@DomainServiceLayout`], 
xref:rgant.adoc#_rgant-DomainObjectLayout_named[`@DomainObjectLayout`], 
xref:rgant.adoc#_rgant-PropertyLayout_named[`@PropertyLayout`], 
xref:rgant.adoc#_rgant-CollectionLayout_named[`@CollectionLayout`], 
xref:rgant.adoc#_rgant-ActionLayout_named[`@ActionLayout`] and 
xref:rgant.adoc#_rgant-ParameterLayout_named[`@ParameterLayout`]
+|`#named()` attribute for 
xref:../rgant/rgant.adoc#_rgant-DomainServiceLayout_named[`@DomainServiceLayout`],
 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_named[`@DomainObjectLayout`],
 xref:../rgant/rgant.adoc#_rgant-PropertyLayout_named[`@PropertyLayout`], 
xref:../rgant/rgant.adoc#_rgant-CollectionLayout_named[`@CollectionLayout`], 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_named[`@ActionLayout`] and 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_named[`@ParameterLayout`]
 |UI
 |Yes
 
 |`@NotContributed`
 |Indicates that a domain service action is not rendered as an action on the 
(entity) types of its parameters.
 For 1-arg query-only actions, controls whether the domain service action is 
rendered as a property or collection on the entity type of its parameter.
-|Use xref:rgant.adoc#_rgant-DomainService_nature[`@DomainService#nature()`] to 
specify whether any of the actions in a domain service should appear in the 
menu bars (applies at type level, not action level).
-For individual actions, use 
xref:rgant.adoc#_rgant-ActionLayout_contributedAs[`@ActionLayout#` +
+|Use 
xref:../rgant/rgant.adoc#_rgant-DomainService_nature[`@DomainService#nature()`] 
to specify whether any of the actions in a domain service should appear in the 
menu bars (applies at type level, not action level).
+For individual actions, use 
xref:../rgant/rgant.adoc#_rgant-ActionLayout_contributedAs[`@ActionLayout#` +
 `contributedAs()`] to specify whether any individual action should be 
contributed only as an action or as an association (property or collection).
 |UI
 |
 
 |`@NotInServiceMenu`
 |Indicates that a domain service should not be rendered in the application 
menu (at top of page in Wicket viewer).
-|xref:rgant.adoc#_rgant-DomainService_nature[`@DomainService#nature()`] to 
signify that none of the actions in a domain service should appear in the menu 
bars
+|xref:../rgant/rgant.adoc#_rgant-DomainService_nature[`@DomainService#nature()`]
 to signify that none of the actions in a domain service should appear in the 
menu bars
 |UI
 |
 
 |`@NotPersisted`
 |Indicates that an object property is not persisted (meaning it is excluded 
from view model mementos, and should not be audited).
-|`#notPersisted()` attribute of 
xref:rgant.adoc#_rgant-Property_notPersisted[`@Property`] and 
xref:rgant.adoc#_rgant-Collection_notPersisted[`@Collection`]
+|`#notPersisted()` attribute of 
xref:../rgant/rgant.adoc#_rgant-Property_notPersisted[`@Property`] and 
xref:../rgant/rgant.adoc#_rgant-Collection_notPersisted[`@Collection`]
 |Domain, Persistence
 |
 
 |`@ObjectType`
 |For constructing the external identifier (URI) of an entity instance (part of 
its URL in both Wicket viewer and Restful Objects viewer).
 Also part of the toString representation of bookmarks, if using the Bookmark 
Service
-|xref:rgant.adoc#_rgant-DomainObject_objectType[`@DomainObject#objectType()`]
+|xref:../rgant/rgant.adoc#_rgant-DomainObject_objectType[`@DomainObject#objectType()`]
 |Domain
 |
 
 |`@Optional`
 |Specifies that a property or action parameter is not mandatory.
-|`#optionality()` attribute for 
xref:rgant.adoc#_rgant-Property_optionality[`@Property`] or  
xref:rgant.adoc#_rgant-Parameter_optionality[`@Parameter`]
+|`#optionality()` attribute for 
xref:../rgant/rgant.adoc#_rgant-Property_optionality[`@Property`] or  
xref:../rgant/rgant.adoc#_rgant-Parameter_optionality[`@Parameter`]
 |Domain
 |
 
 |`@Paged`
 |Number of instances to display in tables representing (standalone or 
parented) collections.
-|`#paged()` attribute for 
xref:rgant.adoc#_rgant-DomainObjectLayout_paged[`@DomainObjectLayout`] or 
xref:rgant.adoc#_rgant-CollectionLayout_paged[`@CollectionLayout`]
+|`#paged()` attribute for 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_paged[`@DomainObjectLayout`] 
or xref:../rgant/rgant.adoc#_rgant-CollectionLayout_paged[`@CollectionLayout`]
 |UI
 |Yes
 
 |`@Plural`
 |For the irregular plural form of an entity type.
-|xref:rgant.adoc#_rgant-DomainObject_plural[`@DomainObjectLayout` +
+|xref:../rgant/rgant.adoc#_rgant-DomainObject_plural[`@DomainObjectLayout` +
 `#plural()`]
 |UI
 |
@@ -249,103 +249,103 @@ Also part of the toString representation of bookmarks, 
if using the Bookmark Ser
 |`@PostsAction` +
 `InvokedEvent`
 |Post a domain event to the Event Bus Service indicating that an action has 
been invoked.
-|xref:rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`]
 |Domain
 |
 
 |`@PostsCollection` +
 `AddedToEvent`
 |Post a domain event to the Event Bus Service indicating that an element has 
been added to a collection.
-|xref:rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`]
+|xref:../rgant/rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`]
 |Domain
 |
 
 |`@PostsCollection` +
 `RemovedFromEvent`
 |Post a domain event to the Event Bus Service indicating that an element has 
been removed from a collection.
-|xref:rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`]
+|xref:../rgant/rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`]
 |Domain
 |
 
 |`@PostsProperty` +
 `ChangedEvent`
 |Post a domain event to the Event Bus Service indicating that the value of a 
property has changed.
-|xref:rgant.adoc#_rgant-Property_domainEvent[`@Property#domainEvent()`]
+|xref:../rgant/rgant.adoc#_rgant-Property_domainEvent[`@Property#domainEvent()`]
 |Domain
 |
 
 |`@PropertyInteraction`
 |Enable subscribers on the Event Bus Service to either veto, validate or take 
further steps before/after a property has been modified or cleared.
-|xref:rgant.adoc#_rgant-Property_domainEvent[`@Property#domainEvent()`]
+|xref:../rgant/rgant.adoc#_rgant-Property_domainEvent[`@Property#domainEvent()`]
 |Domain
 |
 
 |`@Prototype`
 |Indicates that an action should only be visible in 'prototype' mode.
-|xref:rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`]
 |UI
 |Yes
 
 |`@PublishedAction`
 |Action invocation should be serialized and published by configured 
PublishingService (if any), eg to other systems.
-|xref:rgant.adoc#_rgant-Action_publishing[`@Action#publishing()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_publishing[`@Action#publishing()`]
 |Domain
 |
 
 |`@PublishedObject`
 |Change to object should be serialized and published by configured 
PublishingService (if any), eg to other systems.
-|xref:rgant.adoc#_rgant-DomainObject_publishing[`@DomainObject#publishing()`]
+|xref:../rgant/rgant.adoc#_rgant-DomainObject_publishing[`@DomainObject#publishing()`]
 |Domain
 |
 
 |`@QueryOnly`
 |Whether an action is query-only (has no side-effects).
-|xref:rgant.adoc#_rgant-Action_semantics[`@Action#semantics()`]
+|xref:../rgant/rgant.adoc#_rgant-Action_semantics[`@Action#semantics()`]
 |Domain
 |
 
 |`@RegEx`
 |Validate change to value of string property.
-|`#regexPattern()` for 
xref:rgant.adoc#_rgant-Property_regexPattern[`@Property`] or  
xref:rgant.adoc#_rgant-Property_regexPattern[`@Parameter`].
+|`#regexPattern()` for 
xref:../rgant/rgant.adoc#_rgant-Property_regexPattern[`@Property`] or  
xref:../rgant/rgant.adoc#_rgant-Property_regexPattern[`@Parameter`].
 |Domain
 |
 
 |`@Render`
 |Eagerly (or lazily) render the contents of a collection.
-|xref:rgant.adoc#_rgant-CollectionLayout_render[`@CollectionLayout` +
+|xref:../rgant/rgant.adoc#_rgant-CollectionLayout_render[`@CollectionLayout` +
 `#render()`]
 |UI
 |Yes
 
 |`@RenderedAsDayBefore`
 |Render dates as the day before; ie store [a,b) internally but render [a,b-1]) 
to end-user.
-|`#renderedAsDayBefore()` attribute for 
xref:rgant.adoc#_rgant-PropertyLayout_renderedAsDayBefore[`@PropertyLayout`] 
and 
xref:rgant.adoc#_rgant-ParameterLayout_renderedAsDayBefore[`@ParameterLayout`].
+|`#renderedAsDayBefore()` attribute for 
xref:../rgant/rgant.adoc#_rgant-PropertyLayout_renderedAsDayBefore[`@PropertyLayout`]
 and 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_renderedAsDayBefore[`@ParameterLayout`].
 |UI
 |
 
 |`@Resolve`
 |Eagerly (or lazily) render the contents of a collection (same as `@Render)`
-|xref:rgant.adoc#_rgant-CollectionLayout_render[`@CollectionLayout` +
+|xref:../rgant/rgant.adoc#_rgant-CollectionLayout_render[`@CollectionLayout` +
 `#render()`]
 |UI
 |Yes
 
 |`@SortedBy`
 |Display instances in collections in the order determined by the provided 
Comparator.
-|xref:rgant.adoc#_rgant-CollectionLayout_sortedBy[`@CollectionLayout` +
+|xref:../rgant/rgant.adoc#_rgant-CollectionLayout_sortedBy[`@CollectionLayout` 
+
 `#sortedBy()`]
 |UI
 |Yes
 
 |`@TypeOf`
 |The type of entity stored within a collection, or as the result of invoking 
an action, if cannot be otherwise inferred, eg from generics.
-|`#typeOf()` attribute for 
xref:rgant.adoc#_rgant-Collection_typeOf[`@Collection`] and 
xref:rgant.adoc#_rgant-Action_typeOf[`@Action`]
+|`#typeOf()` attribute for 
xref:../rgant/rgant.adoc#_rgant-Collection_typeOf[`@Collection`] and 
xref:../rgant/rgant.adoc#_rgant-Action_typeOf[`@Action`]
 |Domain
 |
 
 |`@TypicalLength`
 |The typical length of a string property, eg to determine a sensible length 
for a textbox.
-|`#typicalLength()` attribute for 
xref:rgant.adoc#_rgant-PropertyLayout_typicalLength[`@PropertyLayout`] and 
xref:rgant.adoc#_rgant-ParameterLayout_typicalLength[`@ParameterLayout`]
+|`#typicalLength()` attribute for 
xref:../rgant/rgant.adoc#_rgant-PropertyLayout_typicalLength[`@PropertyLayout`] 
and 
xref:../rgant/rgant.adoc#_rgant-ParameterLayout_typicalLength[`@ParameterLayout`]
 |UI
 |Yes
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jdo.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jdo.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jdo.adoc
index 8502406..7c40b21 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jdo.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jdo.adoc
@@ -26,7 +26,7 @@ The table below lists the JDO annotations currently 
recognized by Apache Isis.
 |Applies to
 
 
-|xref:rgant.adoc#_rgant-Column[`@javax.jdo.annotations.` +
+|xref:../rgant/rgant.adoc#_rgant-Column[`@javax.jdo.annotations.` +
 `Column`]
 |Used to determine whether a property is mandatory or optional.  For `String` 
and `BigDecimal` properties, used to determine length/precision/scale.
 
@@ -34,16 +34,16 @@ The table below lists the JDO annotations currently 
recognized by Apache Isis.
 |Property
 
 
-|xref:rgant.adoc#_rgant-Discriminator[`@javax.jdo.annotations.` +
+|xref:../rgant/rgant.adoc#_rgant-Discriminator[`@javax.jdo.annotations.` +
 `Discriminator`]
 |Override for the object type, as used in `Bookmark`s, URLs for 
xref:ugvro.adoc#[RestfulObjects viewer] and elsewhere. +
 
-Note that the discriminator overrides the object type that may otherwise be 
inferred from the 
xref:rgant.adoc#_rgant-PersistenceCapable[`@PersistenceCapable`] annotation.
+Note that the discriminator overrides the object type that may otherwise be 
inferred from the 
xref:../rgant/rgant.adoc#_rgant-PersistenceCapable[`@PersistenceCapable`] 
annotation.
 |Domain / persistence
 |Class
 
 
-|xref:rgant.adoc#_rgant-NotPersistent[`@javax.jdo.annotations.` +
+|xref:../rgant/rgant.adoc#_rgant-NotPersistent[`@javax.jdo.annotations.` +
 `NotPersistent`]
 |Used to determine whether to enforce or skip some 
xref:ugbtb.adoc#_ugbtb_programming-model_custom-validator[metamodel validation] 
for `@Column` versus equivalent Isis annotations.
 
@@ -52,17 +52,17 @@ Note that the discriminator overrides the object type that 
may otherwise be infe
 
 
 
-|xref:rgant.adoc#_rgant-PersistenceCapable[`@javax.jdo.annotations.` +
+|xref:../rgant/rgant.adoc#_rgant-PersistenceCapable[`@javax.jdo.annotations.` +
 `PersistenceCapable`]
 |Used to build Apache Isis' own internal identifier for objects. +
 
-If the `schema()` attribute is specified (and if 
xref:rgant.adoc#_rgant-Discriminator[`@Discriminator`] _hasn't_ been 
specified), is also used to derive the object type, as used in `Bookmark`s, 
URLs for xref:ugvro.adoc#[RestfulObjects viewer] and elsewhere.
+If the `schema()` attribute is specified (and if 
xref:../rgant/rgant.adoc#_rgant-Discriminator[`@Discriminator`] _hasn't_ been 
specified), is also used to derive the object type, as used in `Bookmark`s, 
URLs for xref:ugvro.adoc#[RestfulObjects viewer] and elsewhere.
 
 |Domain / persistence
 |Class
 
 
-|xref:rgant.adoc#_rgant-PrimaryKey[`@javax.jdo.annotations.` +
+|xref:../rgant/rgant.adoc#_rgant-PrimaryKey[`@javax.jdo.annotations.` +
 `PrimaryKey`]
 |Used to ensure Apache Isis does not overwrite application-defined primary 
keys, and to ensure is read-only in the UI.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jee.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jee.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jee.adoc
index 42e1a96..5435a7b 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jee.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_jee.adoc
@@ -18,57 +18,57 @@ The table below lists the JEE annotations currently 
recognized.  Expect to see m
 |Layer
 |xref:ugvw.adoc#_ugvw_layout_file-based[File-based layout]?
 
-|xref:rgant.adoc#_rgant-Digits[`@javax.validation.` +
+|xref:../rgant/rgant.adoc#_rgant-Digits[`@javax.validation.` +
 `constraints.` +
 `Digits`]
 |Precision/scale for BigDecimal values.
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-Inject[`@javax.inject.` +
+|xref:../rgant/rgant.adoc#_rgant-Inject[`@javax.inject.` +
 `Inject`]
 |Inject domain service into a domain object (entity or view model) or another 
domain service.
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-Digits[`@javax.annotation.` +
+|xref:../rgant/rgant.adoc#_rgant-Digits[`@javax.annotation.` +
 `Nullable`]
 |Specify that a property/parameter is optional.
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-PostConstruct[`@javax.annotation.` +
+|xref:../rgant/rgant.adoc#_rgant-PostConstruct[`@javax.annotation.` +
 `PostConstruct`]
-|Callback for domain services (either singleton or 
xref:rgant.adoc#_rgant-RequestScoped[request-scoped]) to initialize themselves 
once instantiated.
+|Callback for domain services (either singleton or 
xref:../rgant/rgant.adoc#_rgant-RequestScoped[request-scoped]) to initialize 
themselves once instantiated.
 
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-PreDestroy[`@javax.annotation.` +
+|xref:../rgant/rgant.adoc#_rgant-PreDestroy[`@javax.annotation.` +
 `PreDestroy`]
-|Callback for domain services (either singleton or 
xref:rgant.adoc#_rgant-RequestScoped[request-scoped]) to clean up resources 
prior to destruction.
+|Callback for domain services (either singleton or 
xref:../rgant/rgant.adoc#_rgant-RequestScoped[request-scoped]) to clean up 
resources prior to destruction.
 
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-RequestScoped[`@javax.enterprise.` +
+|xref:../rgant/rgant.adoc#_rgant-RequestScoped[`@javax.enterprise.` +
 `context.` +
 `RequestScoped`]
 |Specify that a domain service has request-scope (rather than a singleton).
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-XmlRootElement[`javax.xml.bind` +
+|xref:../rgant/rgant.adoc#_rgant-XmlRootElement[`javax.xml.bind` +
 `.annotation` +
 `XmlRootElement`]
 |JAXB annotation indicating the XML root element when serialized to XML; also 
used by the framework for view models (whose memento is the XML), often also 
acting as a DTO.
 |Application
 |
 
-|xref:rgant.adoc#_rgant-XmlJavaTypeAdapter[`javax.xml.bind` +
+|xref:../rgant/rgant.adoc#_rgant-XmlJavaTypeAdapter[`javax.xml.bind` +
 `.annotation` +
 `XmlJavaTypeAdapter`]
-|JAXB annotation defining how to serialize an entity.  Used in conjunction 
with the (framework provided) `PersistentEntityAdapter` class to serialize 
persistent entities into a canonical OID (equivalent to the `Bookmark` provided 
by the xref:rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`]).
+|JAXB annotation defining how to serialize an entity.  Used in conjunction 
with the (framework provided) `PersistentEntityAdapter` class to serialize 
persistent entities into a canonical OID (equivalent to the `Bookmark` provided 
by the xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`]).
 |Domain
 |
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_main.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_main.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_main.adoc
index 7b4bd8b..26e6530 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_main.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_main.adoc
@@ -26,72 +26,72 @@ The table below summarizes these most commonly used 
annotations in Apache Isis.
 |Layer
 |xref:ugvw.adoc#_ugvw_layout_file-based[File-based layout]?
 
-|xref:rgant.adoc#_rgant-Action[`@Action`]
+|xref:../rgant/rgant.adoc#_rgant-Action[`@Action`]
 |Domain semantics for actions
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-ActionLayout[`@ActionLayout`]
+|xref:../rgant/rgant.adoc#_rgant-ActionLayout[`@ActionLayout`]
 |User interface hints for actions
 |UI
 |Yes
 
-|xref:rgant.adoc#_rgant-Collection[`@Collection`]
+|xref:../rgant/rgant.adoc#_rgant-Collection[`@Collection`]
 |Domain semantics for collections
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-CollectionLayout[`@CollectionLayout`]
+|xref:../rgant/rgant.adoc#_rgant-CollectionLayout[`@CollectionLayout`]
 |User interface hints for collections
 |UI
 |Yes
 
-|xref:rgant.adoc#_rgant-DomainObject[`@DomainObject`]
+|xref:../rgant/rgant.adoc#_rgant-DomainObject[`@DomainObject`]
 |Domain semantics for domain object (entities and optionally view models, see 
also `@ViewModel)`
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`]
+|xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout[`@DomainObjectLayout`]
 |User interface hints for domain object (entities and optionally view models, 
see also `@ViewModelLayout)`
 |UI
 |Yes
 
-|xref:rgant.adoc#_rgant-DomainService[`@DomainService`]
+|xref:../rgant/rgant.adoc#_rgant-DomainService[`@DomainService`]
 |Class is a domain service (rather than an entity or view model)
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-DomainServiceLayout[`@DomainServiceLayout`]
+|xref:../rgant/rgant.adoc#_rgant-DomainServiceLayout[`@DomainServiceLayout`]
 |User interface hints for domain services
 |UI
 |
 
-|xref:rgant.adoc#_rgant-Parameter[`@Parameter`]
+|xref:../rgant/rgant.adoc#_rgant-Parameter[`@Parameter`]
 |Domain semantics for action parameters
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-ParameterLayout[`@ParameterLayout`]
+|xref:../rgant/rgant.adoc#_rgant-ParameterLayout[`@ParameterLayout`]
 |Layout hints for an action parameter (currently: its label position either to 
top or the left).
 |UI
 |Yes
 
-|xref:rgant.adoc#_rgant-Property[`@Property`]
+|xref:../rgant/rgant.adoc#_rgant-Property[`@Property`]
 |Domain semantics for properties
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-PropertyLayout[`@PropertyLayout`]
+|xref:../rgant/rgant.adoc#_rgant-PropertyLayout[`@PropertyLayout`]
 |Layout hints for a property
 |UI
 |Yes
 
-|xref:rgant.adoc#_rgant-ViewModel[`@ViewModel`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModel[`@ViewModel`]
 |Specify that a class is a view model (as opposed to an entity or domain 
service); equivalent to `@DomainObject(nature`=VIEW_MODEL).
 |Domain, Persistence
 |
 
-|xref:rgant.adoc#_rgant-ViewModelLayout[`@ViewModelLayout`]
+|xref:../rgant/rgant.adoc#_rgant-ViewModelLayout[`@ViewModelLayout`]
 |User interface hints for view models.
 For use with `@ViewModel`. If specifying view models using 
`@DomainObject(nature=VIEW_MODEL)` then use `@DomainObjectLayout`)
 |UI

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_other.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_other.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_other.adoc
index 30ecad9..db3a31a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_other.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgant/_rgant_aaa_other.adoc
@@ -15,34 +15,34 @@ These annotations are also commonly used, but relate _not_ 
to objects or object
 |Layer
 |xref:ugvw.adoc#_ugvw_layout_file-based[File-based layout]?
 
-|xref:rgant.adoc#_rgant-Facets[`@Facets`]
+|xref:../rgant/rgant.adoc#_rgant-Facets[`@Facets`]
 |Install arbitrary facets within the Apache Isis metamodel.
 |(any)
 |
 
-|xref:rgant.adoc#_rgant-HomePage[`@HomePage`]
+|xref:../rgant/rgant.adoc#_rgant-HomePage[`@HomePage`]
 |Query-only action (on domain service) to be invoked, result of which is 
rendered as the user's home page.
 |UI
 |
 
-|xref:rgant.adoc#_rgant-MemberOrder[`@MemberOrder`]
+|xref:../rgant/rgant.adoc#_rgant-MemberOrder[`@MemberOrder`]
 |Ordering of properties, collections and actions, and also associating actions 
with either a property or a collection.
 |UI
 |Yes
 
 
-|xref:rgant.adoc#_rgant-MinLength[`@MinLength`]
+|xref:../rgant/rgant.adoc#_rgant-MinLength[`@MinLength`]
 |Minimum number of characters required for an auto-complete search argument.
 |UI
 |
 
 
-|xref:rgant.adoc#_rgant-Programmatic[`@Programmatic`]
+|xref:../rgant/rgant.adoc#_rgant-Programmatic[`@Programmatic`]
 |Ignore a public method, excluded from the Apache Isis metamodel.
 |Domain
 |
 
-|xref:rgant.adoc#_rgant-Title[`@Title`]
+|xref:../rgant/rgant.adoc#_rgant-Title[`@Title`]
 |Indicates which of the object's properties should be used to build up a title 
for the object.
 |UI
 

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
index 621d8c5..bd72906 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_configuring-core.adoc
@@ -29,21 +29,21 @@ Configuration properties for the JDO/DataNucleus 
objectstore can be found in the
 `domainEvent.postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`] is not 
specified (is set to `ActionDomainEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`] is 
not specified (is set to `ActionDomainEvent.Default`).
 
 |`isis.reflector.facet.` +
 `collectionAnnotation.` +
 `domainEvent.postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`] is 
not specified (is set to `CollectionDomainEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-Collection_domainEvent[`@Collection#domainEvent()`]
 is not specified (is set to `CollectionDomainEvent.Default`).
 
 |`isis.reflector.facet.` +
 `propertyAnnotation.` +
 `domainEvent.postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-Property_domainEvent[`@Property#domainEvent()`] is not 
specified (is set to `PropertyDomainEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-Property_domainEvent[`@Property#domainEvent()`] 
is not specified (is set to `PropertyDomainEvent.Default`).
 
 
 
@@ -70,7 +70,7 @@ Configuration properties for the JDO/DataNucleus objectstore 
can be found in the
 `postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObject_createdLifecycleEvent[`@DomainObject#createdLifecycleEvent()`]
 is not specified (is set to `ObjectCreatedEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObject_createdLifecycleEvent[`@DomainObject#createdLifecycleEvent()`]
 is not specified (is set to `ObjectCreatedEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectAnnotation.` +
@@ -78,7 +78,7 @@ Configuration properties for the JDO/DataNucleus objectstore 
can be found in the
 `postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObject_loadedLifecycleEvent[`@DomainObject#loadedLifecycleEvent()`]
 is not specified (is set to `ObjectLoadedEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObject_loadedLifecycleEvent[`@DomainObject#loadedLifecycleEvent()`]
 is not specified (is set to `ObjectLoadedEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectAnnotation.` +
@@ -86,7 +86,7 @@ Configuration properties for the JDO/DataNucleus objectstore 
can be found in the
 `postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObject_persistingLifecycleEvent[`@DomainObject#persistingLifecycleEvent()`]
 is not specified (is set to `ObjectPersistingEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObject_persistingLifecycleEvent[`@DomainObject#persistingLifecycleEvent()`]
 is not specified (is set to `ObjectPersistingEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectAnnotation.` +
@@ -94,7 +94,7 @@ Configuration properties for the JDO/DataNucleus objectstore 
can be found in the
 `postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObject_persistedLifecycleEvent[`@DomainObject#persistedLifecycleEvent()`]
 is not specified (is set to `ObjectPersistedEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObject_persistedLifecycleEvent[`@DomainObject#persistedLifecycleEvent()`]
 is not specified (is set to `ObjectPersistedEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectAnnotation.` +
@@ -102,7 +102,7 @@ Configuration properties for the JDO/DataNucleus 
objectstore can be found in the
 `postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObject_removingLifecycleEvent[`@DomainObject#removingLifecycleEvent()`]
 is not specified (is set to `ObjectRemovingEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObject_removingLifecycleEvent[`@DomainObject#removingLifecycleEvent()`]
 is not specified (is set to `ObjectRemovingEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectAnnotation.` +
@@ -110,7 +110,7 @@ Configuration properties for the JDO/DataNucleus 
objectstore can be found in the
 `postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObject_updatingLifecycleEvent[`@DomainObject#updatingLifecycleEvent()`]
 is not specified (is set to `ObjectUpdatingEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObject_updatingLifecycleEvent[`@DomainObject#updatingLifecycleEvent()`]
 is not specified (is set to `ObjectUpdatingEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectAnnotation.` +
@@ -118,7 +118,7 @@ Configuration properties for the JDO/DataNucleus 
objectstore can be found in the
 `postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObject_updatedLifecycleEvent[`@DomainObject#updatedLifecycleEvent()`]
 is not specified (is set to `ObjectUpdatedEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObject_updatedLifecycleEvent[`@DomainObject#updatedLifecycleEvent()`]
 is not specified (is set to `ObjectUpdatedEvent.Default`).
 
 
 
@@ -145,21 +145,21 @@ Configuration properties for the JDO/DataNucleus 
objectstore can be found in the
 `cssClassUiEvent.postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObjectLayout_cssClassUiEvent[`@DomainObjectLayout#cssClassUiEvent()`]
 is not specified (is set to `CssClassUiEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_cssClassUiEvent[`@DomainObjectLayout#cssClassUiEvent()`]
 is not specified (is set to `CssClassUiEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectLayoutAnnotation.` +
 `iconUiEvent.postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObjectLayout_iconUiEvent[`@DomainObjectLayout#iconUiEvent()`]
 is not specified (is set to `IconUiEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_iconUiEvent[`@DomainObjectLayout#iconUiEvent()`]
 is not specified (is set to `IconUiEvent.Default`).
 
 |`isis.reflector.facet.` +
 `domainObjectLayoutAnnotation.` +
 `titleUiEvent.postForDefault`
 |`true`,`false` +
 (`true`)
-|Whether an event should be posted if 
xref:rgant.adoc#_rgant-DomainObjectLayout_titleUiEvent[`@DomainObjectLayout#titleUiEvent()`]
 is not specified (is set to `TitleUiEvent.Default`).
+|Whether an event should be posted if 
xref:../rgant/rgant.adoc#_rgant-DomainObjectLayout_titleUiEvent[`@DomainObjectLayout#titleUiEvent()`]
 is not specified (is set to `TitleUiEvent.Default`).
 
 
 
@@ -185,9 +185,9 @@ Configuration properties for the JDO/DataNucleus 
objectstore can be found in the
 |`FQCN`,`FQCN2`,...
 |Fully qualified class names of classes to be instantiated as domain services. 
 +
 
-Each entry can be optionally prefixed by "n:" specifying the relative order on 
the menu (corresponds to 
xref:rgant.adoc#_rgant-DomainServiceLayout_menuOrder[`@DomainServiceLayout#menuOrder()`]).
+Each entry can be optionally prefixed by "n:" specifying the relative order on 
the menu (corresponds to 
xref:../rgant/rgant.adoc#_rgant-DomainServiceLayout_menuOrder[`@DomainServiceLayout#menuOrder()`]).
 
-This property is IGNORED if the 
xref:rgcfg.adoc#_rgcfg_configuring-components[`isis.appManifest`] configuration 
property is specified, or if an 
xref:rgcms.adoc#_rgcms_classes_super_AppManifest[`AppManifest`] is provided 
programmatically.
+This property is IGNORED if the 
xref:../rgcfg/rgcfg.adoc#_rgcfg_configuring-components[`isis.appManifest`] 
configuration property is specified, or if an 
xref:../rgcms/rgcms.adoc#_rgcms_classes_super_AppManifest[`AppManifest`] is 
provided programmatically.
 
 
 |`isis.services.` +
@@ -206,14 +206,14 @@ Lazy initialization can speed up bootstrapping, useful 
while developing and runn
 `objects`
 | `all`, `none` +
 (`all`)
-|Whether the changed properties of objects should be automatically audited 
(for objects annotated with 
xref:rgant.adoc#_rgant-DomainObject_auditing[`@DomainObject(auditing=Auditing.AS_CONFIGURED)`].
+|Whether the changed properties of objects should be automatically audited 
(for objects annotated with 
xref:../rgant/rgant.adoc#_rgant-DomainObject_auditing[`@DomainObject(auditing=Auditing.AS_CONFIGURED)`].
 
 
 |`isis.services.` +
 `command.` +
 `actions`
 | `all`, `ignoreSafe`, `none` (`all`)
-|Whether action invocations should be automatically reified into commands (for 
actions annotated with 
xref:rgant.adoc#_rgant-Action_command[`@Action(command=CommandReification.AS_CONFIGURED)`].
  +
+|Whether action invocations should be automatically reified into commands (for 
actions annotated with 
xref:../rgant/rgant.adoc#_rgant-Action_command[`@Action(command=CommandReification.AS_CONFIGURED)`].
  +
 
 `ignoreQueryOnly` is an alias for `ignoreSafe`.
 
@@ -221,7 +221,7 @@ Lazy initialization can speed up bootstrapping, useful 
while developing and runn
 `command.` +
 `properties`
 | `all`, `none` (`all`)
-|(Whether property edits should be automatically reified into commands (for 
properties annotated with 
xref:rgant.adoc#_rgant-Property_command[`@Property(command=CommandReification.AS_CONFIGURED)`].
  +
+|(Whether property edits should be automatically reified into commands (for 
properties annotated with 
xref:../rgant/rgant.adoc#_rgant-Property_command[`@Property(command=CommandReification.AS_CONFIGURED)`].
  +
 
 
 |`isis.services.` +
@@ -241,7 +241,7 @@ Lazy initialization can speed up bootstrapping, useful 
while developing and runn
 (depends)
 |If a domain object has been mapped to the specified JAXB `x-ro-domain-type`, 
then determines whether the result is pretty-printed or not. +
 
-If no configuration property is available, then the defaults is determined by 
the xref:rgcfg.adoc#_rgcfg_deployment-types[deployment type]: production mode 
disables pretty printing, while prototype mode enables it.
+If no configuration property is available, then the defaults is determined by 
the xref:../rgcfg/rgcfg.adoc#_rgcfg_deployment-types[deployment type]: 
production mode disables pretty printing, while prototype mode enables it.
 
 
 
@@ -277,7 +277,7 @@ NB: note that the key is mis-spelt, (`isis.service.email` 
rather than `isis.serv
 `email.` +
 `port` +
 | port number (`_587_`)
-|The port number for the SMTP service on the the external SMTP host (used by 
xref:rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).  +
+|The port number for the SMTP service on the the external SMTP host (used by 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).  +
 
 NB: note that the key is mis-spelt, (`isis.service.email` rather than 
`isis.services.email`)
 
@@ -286,7 +286,7 @@ NB: note that the key is mis-spelt, (`isis.service.email` 
rather than `isis.serv
 `email.` +
 `sender.address` +
 | email address
-|The email address to use for sending out email (used by 
xref:rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).
+|The email address to use for sending out email (used by 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).
 *Mandatory*.  +
 
 NB: note that the key is mis-spelt, (`isis.service.email` rather than 
`isis.services.email`)
@@ -296,7 +296,7 @@ NB: note that the key is mis-spelt, (`isis.service.email` 
rather than `isis.serv
 `email.` +
 `sender.hostname` +
 | host (`_smtp.gmail.com_`)
-|The hostname of the external SMTP provider (used by 
xref:rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).  +
+|The hostname of the external SMTP provider (used by 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).  +
 
 NB: note that the key is mis-spelt, (`isis.service.email` rather than 
`isis.services.email`)
 
@@ -305,7 +305,7 @@ NB: note that the key is mis-spelt, (`isis.service.email` 
rather than `isis.serv
 `email.` +
 `sender.password` +
 | email password
-|The corresponding password for the email address to use for sending out email 
(used by xref:rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).
+|The corresponding password for the email address to use for sending out email 
(used by xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).
 *Mandatory*.  +
 
 NB: note that the key is mis-spelt, (`isis.service.email` rather than 
`isis.services.email`)
@@ -350,7 +350,7 @@ NB: note that the key is mis-spelt, (`isis.service.email` 
rather than `isis.serv
 `tls.enabled`
 |`true`,`false` +
 (`true`)
-|Whether to enable TLS for the email SMTP connection (used by 
xref:rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).  +
+|Whether to enable TLS for the email SMTP connection (used by 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`]).  +
 
 NB: note that the key is mis-spelt, (`isis.service.email` rather than 
`isis.services.email`)
 
@@ -360,7 +360,7 @@ NB: note that the key is mis-spelt, (`isis.service.email` 
rather than `isis.serv
 `implementation` +
 | `guava`, `axon`, +
 FQCN (`_guava_`)
-|which implementation to use by the 
xref:rgsvc.adoc#_rgsvc_api_EventBusService[`EventBusService`] as the underlying 
event bus.
+|which implementation to use by the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EventBusService[`EventBusService`] as the 
underlying event bus.
 
 | `isis.services.` +
 `eventbus.` +
@@ -368,7 +368,7 @@ FQCN (`_guava_`)
 `Registration` +
 |`true`,`false` +
 (`false`)
-|whether a domain service can register with the 
xref:rgsvc.adoc#_rgsvc_api_EventBusService[`EventBusService`] after any events 
have posted. +
+|whether a domain service can register with the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EventBusService[`EventBusService`] after 
any events have posted. +
 
 Since this almost certainly constitutes a bug in application code, by default 
this is disallowed.
 
@@ -426,20 +426,20 @@ If the setting is changed to disabled then this may 
reduce application start-up
 `objects`
 | `all`, `none` +
 (`all`)
-|Whether changed objects should be automatically published (for objects 
annotated with 
xref:rgant.adoc#_rgant-DomainObject_publishing[`@DomainObject(publishing=Publishing.AS_CONFIGURED)`].
+|Whether changed objects should be automatically published (for objects 
annotated with 
xref:../rgant/rgant.adoc#_rgant-DomainObject_publishing[`@DomainObject(publishing=Publishing.AS_CONFIGURED)`].
 
 
 |`isis.services.` +
 `publish.` +
 `actions`
 | `all`, `ignoreSafe`, `none` (`none`)
-|Whether actions should be automatically published (for actions annotated with 
xref:rgant.adoc#_rgant-Action_publishing[`@Action(publishing=Publishing.AS_CONFIGURED)`].
 +
+|Whether actions should be automatically published (for actions annotated with 
xref:../rgant/rgant.adoc#_rgant-Action_publishing[`@Action(publishing=Publishing.AS_CONFIGURED)`].
 +
 
 |`isis.services.` +
 `publish.` +
 `properties`
 | `all`, `none` (`none`)
-|Whether properties should be automatically published (for properties 
annotated with 
xref:rgant.adoc#_rgant-Action_publishing[`@Property(publishing=Publishing.AS_CONFIGURED)`].
 +
+|Whether properties should be automatically published (for properties 
annotated with 
xref:../rgant/rgant.adoc#_rgant-Action_publishing[`@Property(publishing=Publishing.AS_CONFIGURED)`].
 +
 
 
 |`isis.services.` +
@@ -449,7 +449,7 @@ If the setting is changed to disabled then this may reduce 
application start-up
 |fully qualified package names (CSV)
 |to search for domain services (including all subpackages).
 
-This property is IGNORED if the 
xref:rgcfg.adoc#_rgcfg_configuring-components[`isis.appManifest`] configuration 
property is specified, or if an 
xref:rgcms.adoc#_rgcms_classes_super_AppManifest[`AppManifest`] is provided 
programmatically.
+This property is IGNORED if the 
xref:../rgcfg/rgcfg.adoc#_rgcfg_configuring-components[`isis.appManifest`] 
configuration property is specified, or if an 
xref:../rgcms/rgcms.adoc#_rgcms_classes_super_AppManifest[`AppManifest`] is 
provided programmatically.
 
 
 |`isis.services.` +
@@ -507,7 +507,7 @@ See also `isis.reflector.facets.ignoreDeprecated`.
 (`false`)
 | Whether to check that the class has an object type explicitly specified 
somehow.
 
-The object type is used by the framework as an alias for the object's concrete 
class; it is one part of the object's OID and can be seen in the URLs of the 
xref:ugvw.adoc#[Wicket viewer] and xref:ugvro.adoc#[Restful Objects viewer], 
and is encoded in the ``Bookmark``s returned by the 
xref:rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`].
+The object type is used by the framework as an alias for the object's concrete 
class; it is one part of the object's OID and can be seen in the URLs of the 
xref:ugvw.adoc#[Wicket viewer] and xref:ugvro.adoc#[Restful Objects viewer], 
and is encoded in the ``Bookmark``s returned by the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`].
 In this was it may also be persisted, for example in polymorphic associations 
or command or auditing tables.
 
 If the object type is not specified explicitly, then this can cause data 
migration issues if the class is subsequently refactored (eg renamed, or moved 
to a different package).
@@ -544,10 +544,10 @@ This is by way of possibly deprecating and eventually 
moving contributed service
 `noParamsOnly`
 |`true`,`false` +
 (`false`)
-| When searching for  
xref:rgcms.adoc#_rgcms_methods_prefixes_disable[`disableXxx()`] or 
xref:rgcms.adoc#_rgcms_methods_prefixes_hide[`hideXxx()`] methods, whether to 
search only for the no-param version (or also for supporting methods that match 
the parameter types of the action). +
+| When searching for  
xref:../rgcms/rgcms.adoc#_rgcms_methods_prefixes_disable[`disableXxx()`] or 
xref:../rgcms/rgcms.adoc#_rgcms_methods_prefixes_hide[`hideXxx()`] methods, 
whether to search only for the no-param version (or also for supporting methods 
that match the parameter types of the action). +
 
 If enabled then will not search for supporting methods with the exact set of 
arguments as the method it was supporting (and any supporting methods that have 
additional parameters will be treated as invalid).
-Note that this in effect means that 
xref:rgcms.adoc#_rgcms_classes_mixins[mixins] must be used instead of 
xref:ugbtb.adoc#_ugbtb_decoupling_contributions[contributed services].
+Note that this in effect means that 
xref:../rgcms/rgcms.adoc#_rgcms_classes_mixins[mixins] must be used instead of 
xref:ugbtb.adoc#_ugbtb_decoupling_contributions[contributed services].
 
 
 |`isis.reflector.validator.` +
@@ -579,7 +579,7 @@ If enabled, this configuration property will ensure that 
domain services only de
 `editing`
 |`true`,`false` +
 (`true`)
-|Whether objects' properties and collections can be edited directly (for 
objects annotated with 
xref:rgant.adoc#_rgant-DomainObject_editing[`@DomainObject#editing()`]); see 
xref:rgcfg.adoc#__rgcfg_configuring-core_isis-objects-editing[below] for 
further discussion.
+|Whether objects' properties and collections can be edited directly (for 
objects annotated with 
xref:../rgant/rgant.adoc#_rgant-DomainObject_editing[`@DomainObject#editing()`]);
 see 
xref:../rgcfg/rgcfg.adoc#__rgcfg_configuring-core_isis-objects-editing[below] 
for further discussion.
 
 
 |`isis.persistor.` +
@@ -597,14 +597,14 @@ Only intended for "emergency use" as a workaround while 
pending fix/patch to Apa
 |regex:css1, regex2:css2,...
 |Comma separated list of key:value pairs, where the key is a regex matching 
action names (eg `delete.*`) and the value is a 
link:http://getbootstrap.com/css/[Bootstrap] CSS button class (eg `btn-warning) 
to be applied (as per `@CssClass()`) to all action members matching the regex. +
 
-See xref:ugfun.adoc#_ugfun_how-tos_ui-hints_action-icons-and-css[UI hints] for 
more details.
+See xref:../ugfun/ugfun.adoc#_ugfun_how-tos_ui-hints_action-icons-and-css[UI 
hints] for more details.
 
 |`isis.reflector.facet.` +
 `cssClassFa.patterns`
 |regex:fa-icon,regex2:fa-icon2,...
 |Comma separated list of key:value pairs, where the key is a regex matching 
action names (eg `create.*`) and the value is a 
link:http://fortawesome.github.io/Font-Awesome/icons/[font-awesome] icon name 
(eg `fa-plus`) to be applied (as per `@CssClassFa()`) to all action members 
matching the regex. +
 
-See xref:ugfun.adoc#_ugfun_how-tos_ui-hints_action-icons-and-css[UI hints] for 
more details.
+See xref:../ugfun/ugfun.adoc#_ugfun_how-tos_ui-hints_action-icons-and-css[UI 
hints] for more details.
 
 
 |`isis.reflector.facet.` +
@@ -613,7 +613,7 @@ See 
xref:ugfun.adoc#_ugfun_how-tos_ui-hints_action-icons-and-css[UI hints] for m
 (`true`)
 |Whether objects should be filtered for visibility. +
 
-See xref:rgcfg.adoc#__rgcfg_configuring-core_filterVisibility[section below] 
for further discussion.
+See xref:../rgcfg/rgcfg.adoc#__rgcfg_configuring-core_filterVisibility[section 
below] for further discussion.
 
 |`isis.reflector.facets`
 |`FQCN`
@@ -679,7 +679,7 @@ See 
xref:ugbtb.adoc#_ugbtb_programming-model_layout-metadata-reader[Layout Metad
 `propertyLayout.labelPosition`
 |`TOP`, `LEFT` +
 (`LEFT`)
-|Default for label position for all properties if not explicitly specified 
using 
xref:rgant.adoc#_rgant-PropertyLayout_labelPosition[`@PropertyLayout#labelPosition()`]
+|Default for label position for all properties if not explicitly specified 
using 
xref:../rgant/rgant.adoc#_rgant-PropertyLayout_labelPosition[`@PropertyLayout#labelPosition()`]
 
 |===
 
@@ -717,7 +717,7 @@ By default this configuration property is enabled.  To 
disable the visibility fi
 isis.reflector.facet.filterVisibility=false
 ----
 
-Filtering is supported by the xref:ugvw.adoc#[Wicket viewer] and the 
xref:ugvro.adoc#[Restful Objects viewer], and also by the 
xref:rgsvc.adoc#_rgsvc_api_WrapperFactory[`WrapperFactory`] domain service 
(provided the wrapper's execution mode is __not__ "skip rules").
+Filtering is supported by the xref:ugvw.adoc#[Wicket viewer] and the 
xref:ugvro.adoc#[Restful Objects viewer], and also by the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_WrapperFactory[`WrapperFactory`] domain 
service (provided the wrapper's execution mode is __not__ "skip rules").
 
 [NOTE]
 ====

http://git-wip-us.apache.org/repos/asf/isis/blob/252c2f8e/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_deployment-types.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_deployment-types.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_deployment-types.adoc
index 0fe5e2d..b29d0f4 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_deployment-types.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcfg/_rgcfg_deployment-types.adoc
@@ -9,7 +9,7 @@ Apache Isis distinguishes between the application being run in 
development mode
 
 (For mostly historical reasons) development mode is actually called 
`SERVER_PROTOTYPE`, while production mode is called just `SERVER`.  (There is 
also a deprecated mode called `SERVER_EXPLORATION`; for all intents and 
purposes this can considered as an alias of `SERVER_PROTOTYPE`).
 
-When running in development/prototyping mode, certain capabilities are 
enabled; most notably any actions restricted to prototyping mode (using 
xref:rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`]) will be 
available.
+When running in development/prototyping mode, certain capabilities are 
enabled; most notably any actions restricted to prototyping mode (using 
xref:../rgant/rgant.adoc#_rgant-Action_restrictTo[`@Action#restrictTo()`]) will 
be available.
 
 
 

Reply via email to