http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_cssClass.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_cssClass.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_cssClass.adoc
index 12ac2eb..0f578bc 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_cssClass.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_cssClass.adoc
@@ -8,7 +8,7 @@
 
 The `cssClass()` returns a CSS class for a particular object instance.
 
-The xref:ugvw.adoc#[Wicket viewer] wraps the object's representation in a 
containing `<div>` with the class added.  This is done both for rendering the 
object either in a table or when rendering the object on its own page.
+The xref:../ugvw/ugvw.adoc#[Wicket viewer] wraps the object's representation 
in a containing `<div>` with the class added.  This is done both for rendering 
the object either in a table or when rendering the object on its own page.
 
 In conjunction with 
xref:../rgcfg/rgcfg.adoc#_rgcfg_application-specific_application-css[`application.css`],
 can therefore provide custom styling of an object instance wherever it is 
rendered. +
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_disable.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_disable.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_disable.adoc
index 765062b..46a0924 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_disable.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_disable.adoc
@@ -18,7 +18,7 @@ public String disable(Identifier.Type identifierType) { ... }
 
 where `Identifier.Type` is part of the Isis applib (nested static class of 
`o.a.i.applib.Identifier`) to distinguish between an interaction with an 
action, a property or an action.
 
-Note that Apache Isis' xref:ugbtb.adoc#_ugbtb_i18n[i18n support] extends this 
so that the returned reason can also be internationalized.
+Note that Apache Isis' xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[i18n support] 
extends this so that the returned reason can also be internationalized.
 
 For example:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_getId.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_getId.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_getId.adoc
index 4d2d081..1d7ced9 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_getId.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_getId.adoc
@@ -13,8 +13,8 @@ This can appear in several contexts, including:
 * as the value of `Bookmark#getObjectType()` and in the `toString()` value of 
`Bookmark`
  (see xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`])
 * 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] (specifically, for 
bookmarked actions)
+* in the URLs of the xref:../ugvro/ugvro.adoc#[RestfulObjects viewer]
+* in the URLs of the xref:../ugvw/ugvw.adoc#[Wicket viewer] (specifically, for 
bookmarked actions)
 
 
 
@@ -47,7 +47,7 @@ The rules of precedence are:
 This might be obvious, but to make explicit: we recommend that you always 
specify an object type for your domain services.
 
 Otherwise, if you refactor your code (change class name or move package), then 
any externally held references to the OID of the service will break.
-At best this will require a data migration in the database; at worst it could 
cause external clients accessing data through the xref:ugvro.adoc#[Restful 
Objects] viewer to break.
+At best this will require a data migration in the database; at worst it could 
cause external clients accessing data through the 
xref:../ugvro/ugvro.adoc#[Restful Objects] viewer to break.
 ====
 
 [NOTE]

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_iconName.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_iconName.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_iconName.adoc
index 9f5a97e..0af3731 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_iconName.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_iconName.adoc
@@ -5,7 +5,7 @@
 :_imagesdir: images/
 
 
-Every object is represented by an icon; this is based on the domain object's 
simple name.  The xref:ugvw.adoc#[Wicket viewer] searches for the image in the 
same package as the `.class` file for the domain object or in the `images` 
package. It will find any matching name and one of the followign suffexes 
`png`, `gif`, `jpeg`, `jpg`, `svg`. If none is found, then `Default.png` will 
be used as fallback.
+Every object is represented by an icon; this is based on the domain object's 
simple name.  The xref:../ugvw/ugvw.adoc#[Wicket viewer] searches for the image 
in the same package as the `.class` file for the domain object or in the 
`images` package. It will find any matching name and one of the followign 
suffexes `png`, `gif`, `jpeg`, `jpg`, `svg`. If none is found, then 
`Default.png` will be used as fallback.
 
 The `iconName()` allows the icon that to be used to change for individual 
object instances.  These are usually quite subtle, for example to reflect the 
particular status of an object.  The value returned by the `iconName()` method 
is added as a suffix to the base icon name.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_title.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_title.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_title.adoc
index bd64f0e..89da56e 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_title.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_title.adoc
@@ -17,7 +17,7 @@ An object's title can be constructed in various ways, but the 
most flexible is t
 public String title() { ... }
 ----
 
-Note that Apache Isis' xref:ugbtb.adoc#_ugbtb_i18n[i18n support] extends this 
so that titles can also be internationalized.
+Note that Apache Isis' xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[i18n support] 
extends this so that titles can also be internationalized.
 
 For example, the (non-ASF) http://github.com/isisaddons/isis-app-todoapp[Isis 
addons' todoapp] uses this technique to add an overlay for todo items that have 
been completed:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_validate.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_validate.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_validate.adoc
index aa73826..a361b12 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_validate.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgcms/_rgcms_methods_reserved_validate.adoc
@@ -24,4 +24,4 @@ public String validate() { ... }
 
 where the returned string is the reason that the invocation is vetoed.
 
-Note that Apache Isis' xref:ugbtb.adoc#_ugbtb_i18n[i18n support] extends this 
so that the returned reason can also be internationalized.
+Note that Apache Isis' xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[i18n support] 
extends this so that the returned reason can also be internationalized.

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_ContentNegotiationService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_ContentNegotiationService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_ContentNegotiationService.adoc
index 3bd00cc..6a6df6e 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_ContentNegotiationService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_ContentNegotiationService.adoc
@@ -6,7 +6,7 @@
 
 
 
-The `ContentNegotiationService` is a plug-in point for the 
xref:ugvro.adoc#[RestfulObjects viewer] so that it can generate representations 
according to HTTP `Accept` header of the request.  This idea is discussed in 
section 34.1 of the link:http://restfulobjects.org[Restful Objects spec] v1.0.
+The `ContentNegotiationService` is a plug-in point for the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer] so that it can generate 
representations according to HTTP `Accept` header of the request.  This idea is 
discussed in section 34.1 of the link:http://restfulobjects.org[Restful Objects 
spec] v1.0.
 
 The principal motivation is to allow more flexible representations to be 
generated for REST clients that (perhaps through their use of a certain 
Javascript library, say) expect, or at least works best with, a certain style 
of representation.
 
@@ -14,11 +14,11 @@ Another use case is to support "third party" REST clients 
over which you have no
 
 Instead you need to create some sort of stable facade over your domain 
entities, one which you will preserve even if the domain entities change.  
There are three ways in which you can do this:
 
-* first is to solve the problem at the domain layer by defining a regular 
Apache Isis xref:ugbtb.adoc#_ugbtb_view-models[view model].  This is then 
surfaced over the RO viewer.  +
+* first is to solve the problem at the domain layer by defining a regular 
Apache Isis xref:../ugbtb/ugbtb.adoc#_ugbtb_view-models[view model].  This is 
then surfaced over the RO viewer.  +
 +
 If the underlying entities change, then care must be taken to ensure that 
structure of the view model nevertheless is unchanged.
 
-* a second option is to solve the problem at the persistence layer, but 
defining a (SQL) view in the database and then 
xref:ugbtb.adoc#_ugbtb_other-techniques_mapping-rdbms-views[mapping this] to a 
(read-only) entity.  Again this is surfaced by the RO viewer.  +
+* a second option is to solve the problem at the persistence layer, but 
defining a (SQL) view in the database and then 
xref:../ugbtb/ugbtb.adoc#_ugbtb_other-techniques_mapping-rdbms-views[mapping 
this] to a (read-only) entity.  Again this is surfaced by the RO viewer.  +
 +
 If the underlying tables change (as the result of a change in their 
corresponding domain entities) then once more the view must be refactored so 
that it still presents the same structure.
 
@@ -125,7 +125,7 @@ which returns representations according to the 
link:http://restfulobjects.org[Re
 
 * `ContentNegotiationServiceOrgApacheIsisV1` +
 +
-which returns xref:ugvro.adoc#_ugvro_simplified-representations[simplified 
representations]
+which returns 
xref:../ugvro/ugvro.adoc#_ugvro_simplified-representations[simplified 
representations]
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_RepresentationService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_RepresentationService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_RepresentationService.adoc
index 8977f1a..ca62d9a 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_RepresentationService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgfis/_rgfis_spi_RepresentationService.adoc
@@ -7,7 +7,7 @@
 
 
 
-The `RepresentationService` is the main plug-in point for the 
xref:ugvro.adoc#[RestfulObjects viewer] to generate representations.
+The `RepresentationService` is the main plug-in point for the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer] to generate representations.
 
 The default implementation generates representations according to the 
link:http://restfulobjects.org[Restful Objects spec] v1.0.  However, it also 
delegates to the 
xref:../rgfis/rgfis.adoc#_rgfis_spi_ContentNegotiationService[`ContentNegotiationService`]
 which provides a mechanism for altering representations according to the HTTP 
`Accept` header.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
index 614872d..a3fb8d7 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_intro.adoc
@@ -13,7 +13,7 @@ Use to verify at build time that the metamodel of an 
application is valid.  This
 
 * `swagger` +
 +
-Uses the xref:../rgsvc/rgsvc.adoc#_rgsvc_api_SwaggerService[`SwaggerService`] 
to generate link:http://swagger.io[Swagger] spec files that describe the public 
and/or private RESTful APIs exposed by the xref:ugvro.adoc#[RestfulObjects 
viewer].
+Uses the xref:../rgsvc/rgsvc.adoc#_rgsvc_api_SwaggerService[`SwaggerService`] 
to generate link:http://swagger.io[Swagger] spec files that describe the public 
and/or private RESTful APIs exposed by the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer].
 
 * `xsd` +
 +

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
index 44cf269..607ee86 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_swagger.adoc
@@ -7,7 +7,7 @@
 
 
 The `swagger` goal of the `isis-maven-plugin` uses the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_SwaggerService[`SwaggerService`] to
-generate link:http://swagger.io[Swagger] spec files to describe the public 
and/or private RESTful APIs exposed by the xref:ugvro.adoc#[RestfulObjects 
viewer].
+generate link:http://swagger.io[Swagger] spec files to describe the public 
and/or private RESTful APIs exposed by the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer].
 
 These spec files, once generated, can then be used in the build pipeline to 
generate client-side stubs, typically using Swagger's own 
link:https://github.com/swagger-api/swagger-codegen/tree/master/modules/swagger-codegen-maven-plugin[swagger-codegen-maven]
 plugin.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_validate.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_validate.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_validate.adoc
index d086a48..51546a2 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_validate.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_validate.adoc
@@ -161,7 +161,7 @@ If one were to attempt to run the application, the same 
error would appear in th
 
 == Custom validation rules
 
-It is also possible to customize the validation, explained 
xref:ugbtb.adoc#_ugbtb_programming-model_custom-validator[here].  For example, 
you could enforce project-specific conventions by implementing a custom 
`MetaModelValidator`, and registering using a configuration property.
+It is also possible to customize the validation, explained 
xref:../ugbtb/ugbtb.adoc#_ugbtb_programming-model_custom-validator[here].  For 
example, you could enforce project-specific conventions by implementing a 
custom `MetaModelValidator`, and registering using a configuration property.
 
 To support this using `AppManifest`s, override its 
`getConfigurationProperties()` method:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_xsd.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_xsd.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_xsd.adoc
index d4580f7..987fc6c 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_xsd.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgmvn/_rgmvn_xsd.adoc
@@ -7,7 +7,7 @@
 
 
 The `xsd` goal of the `isis-maven-plugin` uses the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_JaxbService[`JaxbService`] to
-generate XSD schemas from any JAXB-annotated 
xref:ugbtb.adoc#_ugbtb_view-models[view model/DTOs].
+generate XSD schemas from any JAXB-annotated 
xref:../ugbtb/ugbtb.adoc#_ugbtb_view-models[view model/DTOs].
 
 This is instead of and preferable to using the JAXB 
link:https://jaxb.java.net/2.2.4/docs/schemagen.html[schemagen]
 tool, because it uses the framework's support (via

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_AcceptHeaderService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_AcceptHeaderService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_AcceptHeaderService.adoc
index f3fac0b..61e26b4 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_AcceptHeaderService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_AcceptHeaderService.adoc
@@ -35,7 +35,7 @@ The default implementation is provided by 
`o.a.i.v.ro.rendering.service.accepthe
 
 [NOTE]
 ====
-Note that the service will only return a list when the request is initiated 
through the xref:ugvro.adoc#[Restful Objects viewer].  Otherwise the service 
will return `null`.
+Note that the service will only return a list when the request is initiated 
through the xref:../ugvro/ugvro.adoc#[Restful Objects viewer].  Otherwise the 
service will return `null`.
 ====
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_ActionInvocationContext.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_ActionInvocationContext.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_ActionInvocationContext.adoc
index 0d84ae4..81832c9 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_ActionInvocationContext.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_ActionInvocationContext.adoc
@@ -58,7 +58,7 @@ public class ToDoItem ... {
 }
 ----
 <1> if invoked as a regular action, return this object;
-<2> otherwise (if invoked on collection of objects), return null, so that the 
xref:ugvw.adoc#[Wicket viewer] will re-render the list of objects
+<2> otherwise (if invoked on collection of objects), return null, so that the 
xref:../ugvw/ugvw.adoc#[Wicket viewer] will re-render the list of objects
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_CommandContext.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_CommandContext.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_CommandContext.adoc
index e48d0b0..970aad4 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_CommandContext.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_CommandContext.adoc
@@ -38,7 +38,7 @@ The 
link:https://www.youtube.com/watch?v=tqXUZkPB3EI[screencast] provides a run-
 
 [NOTE]
 ====
-Note that this screencast shows an earlier version of the 
xref:ugvw.adoc#[Wicket viewer] UI (specifically, pre 1.8.0).
+Note that this screencast shows an earlier version of the 
xref:../ugvw/ugvw.adoc#[Wicket viewer] UI (specifically, pre 1.8.0).
 ====
 
 
@@ -232,7 +232,7 @@ Most of the time a `Command` will be followed directly by 
its corresponding `Int
 is annotated to run in the background (using 
xref:../rgant/rgant.adoc#_rgant-Action_command[`@Action#commandExecuteIn()`], or
 is explicitly created through the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BackgroundService[`BackgroundService`], 
then the actual
 interaction/execution is deferred until some other mechanism invokes the 
command (eg as described
-xref:ugbtb.adoc#_ugbtb_headless-access_BackgroundCommandExecution[here]).  The 
persistence of background commands
+xref:../ugbtb/ugbtb.adoc#_ugbtb_headless-access_BackgroundCommandExecution[here]).
  The persistence of background commands
 requires a configured 
xref:../rgsvc/rgsvc.adoc#_rgsvc_spi_BackgroundCommandService[`BackgroundCommandService`])
 to actually
 persist such commands for execution.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DeepLinkService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DeepLinkService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DeepLinkService.adoc
index 25341d0..d45c7b1 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DeepLinkService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DeepLinkService.adoc
@@ -25,13 +25,13 @@ public interface DeepLinkService {
 ----
 <1> Creates a URI that can be used to obtain a representation of the provided 
domain object in one of the Apache Isis viewers.
 
-The xref:ugvw.adoc#[Wicket viewer] this provides an implementation for 
accessing the representation through this viewer.  (For the 
xref:ugvro.adoc#[RestfulObjects viewer], a URL can be constructed according to 
the link:http://www.restfulobjects.org[Restful Objects spec] in conjunction 
with a `Bookmark` obtained via the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`]).
+The xref:../ugvw/ugvw.adoc#[Wicket viewer] this provides an implementation for 
accessing the representation through this viewer.  (For the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer], a URL can be constructed 
according to the link:http://www.restfulobjects.org[Restful Objects spec] in 
conjunction with a `Bookmark` obtained via the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BookmarkService[`BookmarkService`]).
 
 
 
 == Usage within the framework
 
-The 
xref:../rgsvc/rgsvc.adoc#_rgsvc_spi_EmailNotificationService[`EmailNotificationService`]
 uses this service in order to generate emails as part of 
xref:ugvw.adoc#_ugvw_features_user-registration[user registration].
+The 
xref:../rgsvc/rgsvc.adoc#_rgsvc_spi_EmailNotificationService[`EmailNotificationService`]
 uses this service in order to generate emails as part of 
xref:../ugvw/ugvw.adoc#_ugvw_features_user-registration[user registration].
 
 
 
@@ -48,7 +48,7 @@ The Wicket viewer core framework provides a default 
implementation of this API:
 
 Assuming that the `configuration-and-annotation` services installer is 
configured (implicit if using the
 `AppManifest` to 
xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the 
app]), _and_ that the
-xref:ugvw.adoc#[Wicket viewer] is being used, then an implementation of 
`DeepLinkService` is
+xref:../ugvw/ugvw.adoc#[Wicket viewer] is being used, then an implementation 
of `DeepLinkService` is
 automatically registered and injected (it is annotated with `@DomainService`) 
so no further configuration is required.
 
 To use an alternative implementation, use

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_messages-api.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_messages-api.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_messages-api.adoc
index f5802a1..c725b2a 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_messages-api.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_messages-api.adoc
@@ -23,11 +23,11 @@ public interface DomainObjectContainer {
     ...
 }
 ----
-<1> display as a transient message to the user (not requiring 
acknowledgement).  In the xref:ugvw.adoc#[Wicket viewer] this is implemented as 
a toast that automatically disappears after a period of time.
-<2> ditto, but with translatable string, for xref:ugbtb.adoc#_ugbtb_i18n[i18n 
support].
-<3> warn the user about a situation with the specified message.  In the 
xref:ugvw.adoc#[Wicket viewer] this is implemented as a toast that must be 
closed by the end-user.
+<1> display as a transient message to the user (not requiring 
acknowledgement).  In the xref:../ugvw/ugvw.adoc#[Wicket viewer] this is 
implemented as a toast that automatically disappears after a period of time.
+<2> ditto, but with translatable string, for 
xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[i18n support].
+<3> warn the user about a situation with the specified message.  In the 
xref:../ugvw/ugvw.adoc#[Wicket viewer] this is implemented as a toast that must 
be closed by the end-user.
 <4> ditto, but with translatable string, for i18n support.
-<5> show the user an unexpected application error.  In the 
xref:ugvw.adoc#[Wicket viewer] this is implemented as a toast (with a different 
colour) that must be closed by the end-user.
+<5> show the user an unexpected application error.  In the 
xref:../ugvw/ugvw.adoc#[Wicket viewer] this is implemented as a toast (with a 
different colour) that must be closed by the end-user.
 <6> ditto, but with translatable string, for i18n support.
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_security-api.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_security-api.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_security-api.adoc
index 2bdd0e5..96dd078 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_security-api.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_DomainObjectContainer_security-api.adoc
@@ -42,6 +42,6 @@ public final class RoleMemento {
 }
 ----
 
-The roles associated with the `UserMemento` will be based on the configured 
xref:ugsec.adoc#[security] (typically Shiro).
+The roles associated with the `UserMemento` will be based on the configured 
xref:../ugsec/ugsec.adoc#[security] (typically Shiro).
 
-In addition, when using the xref:ugvw.adoc#[Wicket viewer] there will be an 
additional "org.apache.isis.viewer.wicket.roles.USER" role; this is used 
internally to restrict access to web pages without authenticating.
+In addition, when using the xref:../ugvw/ugvw.adoc#[Wicket viewer] there will 
be an additional "org.apache.isis.viewer.wicket.roles.USER" role; this is used 
internally to restrict access to web pages without authenticating.

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_EmailService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_EmailService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_EmailService.adoc
index 1f44047..e389417 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_EmailService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_EmailService.adoc
@@ -53,7 +53,7 @@ and these properties may optionally be configured (each has a 
default to use gma
 * `isis.service.email.port`
 * `isis.service.email.tls.enabled`
 
-These configuration properties can be specified either in `isis.properties` or 
in an xref:ugbtb.adoc#_ugbtb_deployment_externalized-configuration[external 
configuration file].
+These configuration properties can be specified either in `isis.properties` or 
in an 
xref:../ugbtb/ugbtb.adoc#_ugbtb_deployment_externalized-configuration[external 
configuration file].
 
 If prototyping (that is, running the app using `org.apache.isis.WebServer`), 
the configuration properties can also be specified as system properties.
 For example, if you create a test email account on gmail, you can configure 
the service using:
@@ -99,7 +99,7 @@ The socket connection timeout, defaulting to 2000ms.
 If you wish to write an alternative implementation, be aware that it should 
process the message body as HTML (as opposed to plain text or any other format).
 
 Also, note that (unlike most Apache Isis domain services) the implementation 
is also instantiated and injected by Google Guice.
-This is because `EmailService` is used as part of the 
xref:ugvw.adoc#_ugvw_features_user-registration[user registration] 
functionality and is used by Wicket pages that are accessed outside of the 
usual Apache Isis runtime.
+This is because `EmailService` is used as part of the 
xref:../ugvw/ugvw.adoc#_ugvw_features_user-registration[user registration] 
functionality and is used by Wicket pages that are accessed outside of the 
usual Apache Isis runtime.
 This implies a couple of additional constraints:
 
 * first, implementation class should also be annotated with 
`@com.google.inject.Singleton`

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_FixtureScriptsDefault.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_FixtureScriptsDefault.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_FixtureScriptsDefault.adoc
index 7e45125..25cffc1 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_FixtureScriptsDefault.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_FixtureScriptsDefault.adoc
@@ -6,7 +6,7 @@
 
 
 
-The `FixtureScriptsDefault` service provides the ability to execute 
xref:ugtst.adoc#_ugtst_fixture-scripts_api-and-usage[fixture scripts] .
+The `FixtureScriptsDefault` service provides the ability to execute 
xref:../ugtst/ugtst.adoc#_ugtst_fixture-scripts_api-and-usage[fixture scripts] .
 
 The service extends from the 
xref:../rgcms/rgcms.adoc#_rgcms_classes_super_FixtureScripts[`FixtureScripts`], 
and is only instantiated by the framework if there no custom implementation of 
`FixtureScripts` has been otherwise provided; in other words it is a fallback.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_GuiceBeanProvider.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_GuiceBeanProvider.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_GuiceBeanProvider.adoc
index 5a39ce3..8406df8 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_GuiceBeanProvider.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_GuiceBeanProvider.adoc
@@ -5,7 +5,7 @@
 :_imagesdir: images/
 
 
-The `GuiceBeanProvider` domain service acts as a bridge between Apache Isis' 
xref:ugvw.adoc#[Wicket viewer] internal bootstrapping using 
link:https://github.com/google/guice[Google Guice].
+The `GuiceBeanProvider` domain service acts as a bridge between Apache Isis' 
xref:../ugvw/ugvw.adoc#[Wicket viewer] internal bootstrapping using 
link:https://github.com/google/guice[Google Guice].
 
 This service operates at a very low-level, and you are unlikely to have a need 
for it.  It is used internally by the framework, in the default implementation 
of the xref:../rgsvc/rgsvc.adoc#_rgsvc_api_DeepLinkService[`DeepLinkService`].
 
@@ -29,13 +29,13 @@ public interface GuiceBeanProvider {
 }
 ----
 
-The xref:ugvw.adoc#[Wicket viewer] this provides an implementation of this 
service.
+The xref:../ugvw/ugvw.adoc#[Wicket viewer] this provides an implementation of 
this service.
 
 
 
 == Usage
 
-Using the xref:ugvw.adoc#[Wicket viewer] requires subclassing of 
`IsisWicketApplication`.  In the subclass it is commonplace to override 
`newIsisWicketModule()`, for example:
+Using the xref:../ugvw/ugvw.adoc#[Wicket viewer] requires subclassing of 
`IsisWicketApplication`.  In the subclass it is commonplace to override 
`newIsisWicketModule()`, for example:
 
 [source,java]
 ----
@@ -81,7 +81,7 @@ should return "ToDo App".
 
 Assuming that the `configuration-and-annotation` services installer is 
configured (implicit if using the
 `AppManifest` to 
xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the 
app]), _and_ that the
-xref:ugvw.adoc#[Wicket viewer] is being used, then an implementation of 
`GuiceBeanProvider` is
+xref:../ugvw/ugvw.adoc#[Wicket viewer] is being used, then an implementation 
of `GuiceBeanProvider` is
 automatically registered and injected (it is annotated with `@DomainService`) 
so no further configuration is required.
 
 To use an alternative implementation, use

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_InteractionContext.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_InteractionContext.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_InteractionContext.adoc
index 503640b..8b5b6f4 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_InteractionContext.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_InteractionContext.adoc
@@ -200,6 +200,6 @@ Most of the time a `Command` will be followed directly by 
its corresponding `Int
 is annotated to run in the background (using 
xref:../rgant/rgant.adoc#_rgant-Action_command[`@Action#commandExecuteIn()`], or
 is explicitly created through the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_BackgroundService[`BackgroundService`], 
then the actual
 interaction/execution is deferred until some other mechanism invokes the 
command (eg as described
-xref:ugbtb.adoc#_ugbtb_headless-access_BackgroundCommandExecution[here]).
+xref:../ugbtb/ugbtb.adoc#_ugbtb_headless-access_BackgroundCommandExecution[here]).
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_IsisJdoSupport.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_IsisJdoSupport.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_IsisJdoSupport.adoc
index 32e2a48..65b4b45 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_IsisJdoSupport.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_IsisJdoSupport.adoc
@@ -132,7 +132,7 @@ private static <T> List<T> executeListAndClose(final 
TypesafeQuery<T> query) {
 [[__rgsvc_api_IsisJdoSupport_fixture-support]]
 == Fixture support
 
-When writing xref:ugtst.adoc#_ugtst_integ-test-support[integration tests] 
you'll usually need to tear down some/all mutable transactional data before 
each test.  One way to do that is to use the `executeUpdate(...)` method 
described 
xref:../rgsvc/rgsvc.adoc#__rgsvc_api_IsisJdoSupport_executing-sql[above].
+When writing xref:../ugtst/ugtst.adoc#_ugtst_integ-test-support[integration 
tests] you'll usually need to tear down some/all mutable transactional data 
before each test.  One way to do that is to use the `executeUpdate(...)` method 
described 
xref:../rgsvc/rgsvc.adoc#__rgsvc_api_IsisJdoSupport_executing-sql[above].
 
 Alternatively, the `deleteAll(...)` method will let your test delete all 
instances of a class without resorting to SQL:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_JaxbService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_JaxbService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_JaxbService.adoc
index 9e99ef3..1cc6cc1 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_JaxbService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_JaxbService.adoc
@@ -50,7 +50,7 @@ Isis provides a default implementation of the service, 
`o.a.i.schema.services.ja
 
 This service is provided as a convenience for applications, but is also used 
internally by the framework to
 xref:../rgant/rgant.adoc#_rgant-XmlRootElement[`@XmlRootElement`]-annotated
-xref:ugbtb.adoc#_ugbtb_view-models[view models].  The functionality to 
download XML and XSD schemas is also
+xref:../ugbtb/ugbtb.adoc#_ugbtb_view-models[view models].  The functionality 
to download XML and XSD schemas is also
 exposed in the UI through mixins to 
xref:../rgcms/rgcms.adoc#_rgcms_classes_mixins_Dto[`Dto`] interface.
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MementoService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MementoService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MementoService.adoc
index 15f5f60..11caf67 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MementoService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MementoService.adoc
@@ -7,8 +7,8 @@
 
 
 The `MementoService` was originally introduced to simplify the implementation 
of
-xref:ugbtb.adoc#_ugbtb_view-models[ViewModel]s which are required by the 
framework to return string representation of
-all of their backing state, moreover which is safe for use within a URL.  This 
usage is deprecated; use xref:ugbtb.adoc#_ugbtb_view-models_jaxb[JAXB view 
models] instead.
+xref:../ugbtb/ugbtb.adoc#_ugbtb_view-models[ViewModel]s which are required by 
the framework to return string representation of
+all of their backing state, moreover which is safe for use within a URL.  This 
usage is deprecated; use xref:../ugbtb/ugbtb.adoc#_ugbtb_view-models_jaxb[JAXB 
view models] instead.
 
 The service can also be used to create a memento of arbitrary objects, however 
this usage is also deprecated.  (Prior
 to `1.13.0` it was used internally by the core implementation of

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MessageService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MessageService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MessageService.adoc
index 7cb42ff..a219987 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MessageService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_MessageService.adoc
@@ -32,11 +32,11 @@ public interface MessageService {
     ...
 }
 ----
-<1> display as a transient message to the user (not requiring 
acknowledgement).  In the xref:ugvw.adoc#[Wicket viewer] this is implemented as 
a toast that automatically disappears after a period of time.
-<2> ditto, but with translatable string, for xref:ugbtb.adoc#_ugbtb_i18n[i18n 
support].
-<3> warn the user about a situation with the specified message.  In the 
xref:ugvw.adoc#[Wicket viewer] this is implemented as a toast that must be 
closed by the end-user.
+<1> display as a transient message to the user (not requiring 
acknowledgement).  In the xref:../ugvw/ugvw.adoc#[Wicket viewer] this is 
implemented as a toast that automatically disappears after a period of time.
+<2> ditto, but with translatable string, for 
xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[i18n support].
+<3> warn the user about a situation with the specified message.  In the 
xref:../ugvw/ugvw.adoc#[Wicket viewer] this is implemented as a toast that must 
be closed by the end-user.
 <4> ditto, but with translatable string, for i18n support.
-<5> show the user an unexpected application error.  In the 
xref:ugvw.adoc#[Wicket viewer] this is implemented as a toast (with a different 
colour) that must be closed by the end-user.
+<5> show the user an unexpected application error.  In the 
xref:../ugvw/ugvw.adoc#[Wicket viewer] this is implemented as a toast (with a 
different colour) that must be closed by the end-user.
 <6> ditto, but with translatable string, for i18n support.
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_Scratchpad.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_Scratchpad.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_Scratchpad.adoc
index d6e09d9..f513b20 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_Scratchpad.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_Scratchpad.adoc
@@ -59,7 +59,7 @@ public BigDecimal totalCost() {
 Scratchpad scratchpad;
 ----
 
-A more complex example could use a xref:ugbtb.adoc#_ugbtb_view-models[view 
model] to enable bulk updates to a set of objects. The view model's job is to 
gather track of the items to be updated:
+A more complex example could use a 
xref:../ugbtb/ugbtb.adoc#_ugbtb_view-models[view model] to enable bulk updates 
to a set of objects. The view model's job is to gather track of the items to be 
updated:
 
 [source,java]
 ----
@@ -100,7 +100,7 @@ Scratchpad scratchpad;
 <1> look for the `ToDoItemBulkUpdate` in the scratchpad...
 <2> ... and add one if there isn't one (ie for the first object returned).
 
-If using the xref:ugvw.adoc#[Wicket viewer], the `ToDoItemBulkUpdate` view 
model returned from the last action invoked will be displayed. Thereafter this 
view model can be used to perform a bulk update of the "enlisted" items.
+If using the xref:../ugvw/ugvw.adoc#[Wicket viewer], the `ToDoItemBulkUpdate` 
view model returned from the last action invoked will be displayed. Thereafter 
this view model can be used to perform a bulk update of the "enlisted" items.
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SudoService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SudoService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SudoService.adoc
index d07b8c3..a95214c 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SudoService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SudoService.adoc
@@ -7,7 +7,7 @@
 
 
 The `SudoService` allows the current user reported by the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_UserService[`UserService`]  to be 
temporarily changed to some other user.
-This is useful both for xref:ugtst.adoc#_ugtst_integ-test-support[integration 
testing] (eg if testing a workflow system whereby objects are moved from one 
user to another) and while running 
xref:ugtst.adoc#_ugtst_fixture-scripts[fixture scripts] (eg setting up objects 
that would normally require several users to have acted upon the objects).
+This is useful both for 
xref:../ugtst/ugtst.adoc#_ugtst_integ-test-support[integration testing] (eg if 
testing a workflow system whereby objects are moved from one user to another) 
and while running xref:../ugtst/ugtst.adoc#_ugtst_fixture-scripts[fixture 
scripts] (eg setting up objects that would normally require several users to 
have acted upon the objects).
 
 
 == API
@@ -36,7 +36,7 @@ The current user/role reported by the internal 
xref:../rgfis/rgfis.adoc#_rgfis_s
 
 [IMPORTANT]
 ====
-Note however that this the "effective user" does not propagate through to the 
xref:ugsec.adoc#[Shiro security mechanism], which will continue to be evaluated 
according to the permissions of the current user.
+Note however that this the "effective user" does not propagate through to the 
xref:../ugsec/ugsec.adoc#[Shiro security mechanism], which will continue to be 
evaluated according to the permissions of the current user.
 See the 
xref:../rgsvc/rgsvc.adoc#__rgsvc_api_SudoService_ACCESS-ALL-ROLE[`ACCESS-ALL-ROLE`]
 below for details of how to circumvent this.
 ====
 
@@ -70,7 +70,7 @@ protected void execute(final ExecutionContext ec) {
 [[__rgsvc_api_SudoService_ACCESS-ALL-ROLE]]
 === ACCESS_ALL_ROLE
 
-When `sudo(...)` is called the "effective user" is reported by both 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_UserService[`UserService`] and by 
xref:../rgfis/rgfis.adoc#_rgfis_spi_AuthenticationSessionProvider[`AuthenticationSessionProvider`],
 but does not propagate through to the xref:ugsec.adoc#[Shiro security 
mechanism].
+When `sudo(...)` is called the "effective user" is reported by both 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_UserService[`UserService`] and by 
xref:../rgfis/rgfis.adoc#_rgfis_spi_AuthenticationSessionProvider[`AuthenticationSessionProvider`],
 but does not propagate through to the xref:../ugsec/ugsec.adoc#[Shiro security 
mechanism].
 These continue to be evaluated according to the permissions of the current 
user.
 
 This can be a problem in certain use cases.

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwaggerService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwaggerService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwaggerService.adoc
index f16f083..03109c9 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwaggerService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwaggerService.adoc
@@ -6,13 +6,13 @@
 
 
 
-The `SwaggerService` generates link:http://swagger.io/[Swagger] spec files to 
describe the public and/or private RESTful APIs exposed by the 
xref:ugvro.adoc#[RestfulObjects viewer].
+The `SwaggerService` generates link:http://swagger.io/[Swagger] spec files to 
describe the public and/or private RESTful APIs exposed by the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer].
 
 These spec files can then be used with the 
link:http://swagger.io/swagger-ui/[Swagger UI] page to explore the REST API, or 
used to generate client-side stubs using the 
link:http://swagger.io/swagger-codegen/[Swagger codegen] tool, eg for use in a 
custom REST client app.
 
 [NOTE]
 ====
-Not all of the REST API exposed by the xref:ugvro.adoc#[Restful Objects 
viewer] is included in the Swagger spec files; the emphasis is those REST 
resources that are used to develop custom apps: domain objects, domain object 
collections and action invocations.  When combined with Apache Isis' own 
xref:ugvro.adoc#_ugvro_simplified-representations[simplified representations], 
these are pretty much all that is needed  for this use case.
+Not all of the REST API exposed by the xref:../ugvro/ugvro.adoc#[Restful 
Objects viewer] is included in the Swagger spec files; the emphasis is those 
REST resources that are used to develop custom apps: domain objects, domain 
object collections and action invocations.  When combined with Apache Isis' own 
xref:../ugvro/ugvro.adoc#_ugvro_simplified-representations[simplified 
representations], these are pretty much all that is needed  for this use case.
 ====
 
 
@@ -38,7 +38,7 @@ public interface SwaggerService {
 }
 ----
 <1> Generate a Swagger spec for use by third-party clients, ie public use.  
This specification is restricted only to
-xref:ugbtb.adoc#_ugbtb_view-models[view model]s and to domain services with a 
xref:../rgant/rgant.adoc#_rgant-DomainService_nature[nature] of 
`VIEW_REST_ONLY`.
+xref:../ugbtb/ugbtb.adoc#_ugbtb_view-models[view model]s and to domain 
services with a xref:../rgant/rgant.adoc#_rgant-DomainService_nature[nature] of 
`VIEW_REST_ONLY`.
 <2> Generate a Swagger spec for use only by internally-managed clients, ie 
private internal use.  This specification includes domain entities and all menu 
domain services (as well as any view models).
 <3> Generate a Swagger spec that is the same as private case (above), but also 
including any xref:../rgant/rgant.adoc#_rgant-Action_restrictTo[prototype] 
actions.
 <4> Swagger specs can be written either in JSON or YAML format.

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwitchUserService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwitchUserService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwitchUserService.adoc
index 60d6de6..f834f73 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwitchUserService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_SwitchUserService.adoc
@@ -13,7 +13,7 @@ different users of the system.
 
 [NOTE]
 ====
-This service is deprecated; use xref:ugtst.adoc#_ugtst_fixture-scripts[fixture 
scripts] and the
+This service is deprecated; use 
xref:../ugtst/ugtst.adoc#_ugtst_fixture-scripts[fixture scripts] and the
 xref:../rgsvc/rgsvc.adoc#_rgsvc_api_SudoService[`SudoService`] instead.
 ====
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_TransactionService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_TransactionService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_TransactionService.adoc
index 9dca04d..7fbc50b 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_TransactionService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_TransactionService.adoc
@@ -35,7 +35,7 @@ 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_RepositoryService[`RepositoryService`]'s `pe
 framework actually queues up the work and only performs the persistence 
command either at the end of the transaction
 or immediately prior to the next query.  Performing a flush will cause any 
pending calls to be performed immediately.
 
-The `nextTransaction()` is also used by the xref:ugvw.adoc#[Wicket viewer]'s 
support for bulk actions; each action
+The `nextTransaction()` is also used by the xref:../ugvw/ugvw.adoc#[Wicket 
viewer]'s support for bulk actions; each action
 is invoked in its own transaction.
 
 The `Transaction` object - as obtained by `currentTransaction()` method, above 
- is a minimal wrapper around the

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_UserService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_UserService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_UserService.adoc
index bca048e..01e6267 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_UserService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_UserService.adoc
@@ -55,9 +55,9 @@ public final class RoleMemento {
 }
 ----
 
-The roles associated with the `UserMemento` will be based on the configured 
xref:ugsec.adoc#[security] (typically Shiro).
+The roles associated with the `UserMemento` will be based on the configured 
xref:../ugsec/ugsec.adoc#[security] (typically Shiro).
 
-In addition, when using the xref:ugvw.adoc#[Wicket viewer] there will be an 
additional "org.apache.isis.viewer.wicket.roles.USER" role; this is used 
internally to restrict access to web pages without authenticating.
+In addition, when using the xref:../ugvw/ugvw.adoc#[Wicket viewer] there will 
be an additional "org.apache.isis.viewer.wicket.roles.USER" role; this is used 
internally to restrict access to web pages without authenticating.
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_WrapperFactory.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_WrapperFactory.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_WrapperFactory.adoc
index 5eaa6b1..e633b0b 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_WrapperFactory.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_api_WrapperFactory.adoc
@@ -13,12 +13,12 @@ For example, if the calling object attempts to modify an 
unmodifiable property o
 
 [NOTE]
 ====
-For a discussion of the use of the `WrapperFactory` within integration tests 
(the primary or at least original use case for this service) can be found 
xref:ugtst.adoc#_ugtst_integ-test-support_wrapper-factory[here]
+For a discussion of the use of the `WrapperFactory` within integration tests 
(the primary or at least original use case for this service) can be found 
xref:../ugtst/ugtst.adoc#_ugtst_integ-test-support_wrapper-factory[here]
 ====
 
 This capability goes beyond enforcing the (imperative) constraints within the 
`hideXxx()`, `disableXxx()` and `validateXxx()` supporting methods; it also 
enforces (declarative) constraints such as those represented by annotations, eg 
`@MaxLength` or `@Regex`.
 
-This capability is frequently used within 
xref:ugtst.adoc#_ugtst_integ-test-support[integration tests], but can also be 
used in production code. (There are analogies that can be drawn here with the 
way that JEE beans can interact through an EJB local interface).
+This capability is frequently used within 
xref:../ugtst/ugtst.adoc#_ugtst_integ-test-support[integration tests], but can 
also be used in production code. (There are analogies that can be drawn here 
with the way that JEE beans can interact through an EJB local interface).
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api.adoc
index 692cd3e..21a68c4 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_application-layer-api.adoc
@@ -27,7 +27,7 @@ The table below summarizes the application layer APIs defined 
by Apache Isis.  I
 |`AcceptHeaderServiceDefault` +
 ``o.a.i.core`` +
 ``isis-viewer-restfulobjects-rendering``
-|Populated only when the domain objects are accessed using the 
xref:ugvro.adoc#[Restful Objects viewer].
+|Populated only when the domain objects are accessed using the 
xref:../ugvro/ugvro.adoc#[Restful Objects viewer].
 
 
 |xref:../rgsvc/rgsvc.adoc#_rgsvc_api_ActionInvocationContext[`o.a.i.applib.` +

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_intro.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_intro.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_intro.adoc
index 38fbc01..5351fec 100644
--- a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_intro.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_intro.adoc
@@ -19,8 +19,8 @@ 
image::{_imagesdir}reference-services/categories.png[width="600px",link="{_image
 
 
 A small number of domain services can be considered both API and SPI; a good 
example is the xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EmailService[`EmailService`] 
that is of direct use for domain objects wishing to send out emails,
-but is also used by the framework to support the 
xref:ugvw.adoc#_ugvw_features_user-registration[user registration]
-functionality supported by the xref:ugvw.adoc#[Wicket viewer].   The same is 
true of the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EventBusService[`EventBusService`]; this 
can be used by domain objects to broadcast arbitrary events,
+but is also used by the framework to support the 
xref:../ugvw/ugvw.adoc#_ugvw_features_user-registration[user registration]
+functionality supported by the xref:../ugvw/ugvw.adoc#[Wicket viewer].   The 
same is true of the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_EventBusService[`EventBusService`]; this 
can be used by domain objects to broadcast arbitrary events,
 but is also used by the framework to automatically emit events for
 xref:../rgant/rgant.adoc#_rgant-Action_domainEvent[`@Action#domainEvent()`] 
etc.
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api.adoc
index 3a3a52e..4c565f4 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_metadata-api.adoc
@@ -70,7 +70,7 @@ within the metamodel.
 |xref:../rgsvc/rgsvc.adoc#_rgsvc_api_SwaggerService[`o.a.i.applib.` +
 `services.swagger` +
 `SwaggerService`]
-|Generates link:http://swagger.io/[Swagger] spec files to describe the public 
and/or private RESTful APIs exposed by the xref:ugvro.adoc#[RestfulObjects 
viewer].  These can then be used with the 
link:http://swagger.io/swagger-ui/[Swagger UI] page to explore the REST API, or 
used to generate client-side stubs using the 
link:http://swagger.io/swagger-codegen/[Swagger codegen] tool, eg for use in a 
custom REST client app.
+|Generates link:http://swagger.io/[Swagger] spec files to describe the public 
and/or private RESTful APIs exposed by the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer].  These can then be used with 
the link:http://swagger.io/swagger-ui/[Swagger UI] page to explore the REST 
API, or used to generate client-side stubs using the 
link:http://swagger.io/swagger-codegen/[Swagger codegen] tool, eg for use in a 
custom REST client app.
 |`SwaggerServiceDefault` +
 ``o.a.i.core`` +
 ``isis-core-metamodel``

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi.adoc
index 6c0ed69..dd72df4 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_presentation-layer-spi.adoc
@@ -126,7 +126,7 @@ grids for any domain class.
 ``o.a.i.core`` +
 ``isis-core-applib``
 |The default implementation will return the home page (per 
xref:../rgsvc/rgsvc.adoc#_rgsvc_api_HomePageProviderService[`HomePageProviderService`])
 if a void or null is returned. +
-Used by the xref:ugvw.adoc#[Wicket viewer] only.
+Used by the xref:../ugvw/ugvw.adoc#[Wicket viewer] only.
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditerService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditerService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditerService.adoc
index e0f435d..85e0ec7 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditerService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditerService.adoc
@@ -109,7 +109,7 @@ Assuming that an `AppManifest` is being used to 
xref:../rgcms/rgcms.adoc#_rgcms_
 then this can be activated by updating the `pom.xml` and updating the 
`AppManifest#getModules()` method.
 
 If menu items or contributions are not required in the UI, these can be 
suppressed either using security or by
-implementing a xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
+implementing a 
xref:../ugbtb/ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditingService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditingService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditingService.adoc
index 63ed0f8..062c87e 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditingService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_AuditingService.adoc
@@ -71,7 +71,7 @@ Assuming that an `AppManifest` is being used to 
xref:../rgcms/rgcms.adoc#_rgcms_
 then this can be activated by updating the `pom.xml` and updating the 
`AppManifest#getModules()` method.
 
 If menu items or contributions are not required in the UI, these can be 
suppressed either using security or by
-implementing a xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
+implementing a 
xref:../ugbtb/ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_BackgroundCommandService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_BackgroundCommandService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_BackgroundCommandService.adoc
index 57ae70e..7040283 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_BackgroundCommandService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_BackgroundCommandService.adoc
@@ -56,7 +56,7 @@ public class ActionInvocationMemento {
 
 == "Internal" SPI
 
-The `BackgroundCommandExecution` (in isis-core) is an abstract template class 
for  
xref:ugbtb.adoc#_ugbtb_headless-access_AbstractIsisSessionTemplate[headless 
access], that defines an abstract hook method to obtain background `Command`s 
to be executed:
+The `BackgroundCommandExecution` (in isis-core) is an abstract template class 
for  
xref:../ugbtb/ugbtb.adoc#_ugbtb_headless-access_AbstractIsisSessionTemplate[headless
 access], that defines an abstract hook method to obtain background `Command`s 
to be executed:
 
 [source,java]
 ----
@@ -114,7 +114,7 @@ Assuming that an `AppManifest` is being used to 
xref:../rgcms/rgcms.adoc#_rgcms_
 then this can be activated by updating the `pom.xml` and updating the 
`AppManifest#getModules()` method.
 
 If contributions are not required in the UI, these can be suppressed either 
using security or by implementing a
-xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing subscriber].
+xref:../ugbtb/ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_CommandService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_CommandService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_CommandService.adoc
index f211af1..d0dcb05 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_CommandService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_CommandService.adoc
@@ -40,7 +40,7 @@ The 
link:https://www.youtube.com/watch?v=tqXUZkPB3EI[screencast] below provides
 
 [NOTE]
 ====
-Note that this screencast shows an earlier version of the 
xref:ugvw.adoc#[Wicket viewer] UI (specifically, pre 1.8.0).
+Note that this screencast shows an earlier version of the 
xref:../ugvw/ugvw.adoc#[Wicket viewer] UI (specifically, pre 1.8.0).
 ====
 
 
@@ -101,7 +101,7 @@ Assuming that an `AppManifest` is being used to 
xref:../rgcms/rgcms.adoc#_rgcms_
 then this can be activated by updating the `pom.xml` and updating the 
`AppManifest#getModules()` method.
 
 If contributions are not required in the UI, these can be suppressed either 
using security or by implementing a
-xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing subscriber].
+xref:../ugbtb/ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ContentMappingService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ContentMappingService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ContentMappingService.adoc
index bb21807..b06c46b 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ContentMappingService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ContentMappingService.adoc
@@ -8,7 +8,7 @@
 
 The `ContentMappingService` supports the (default implementation of the)
 
xref:../rgfis/rgfis.adoc#_rgfis_spi_ContentNegotiationService[`ContentNegotiationService`]
 allowing the
-xref:ugvro.adoc#[RestfulObjects viewer] to allow domain objects to be 
transformed into some other format as specified
+xref:../ugvro/ugvro.adoc#[RestfulObjects viewer] to allow domain objects to be 
transformed into some other format as specified
 by the HTTP `Accept` header.
 
 See 
xref:../rgfis/rgfis.adoc#_rgfis_spi_ContentNegotiationService[`ContentNegotiationService`]
 for further discussion.
@@ -42,7 +42,7 @@ public interface ContentMappingService {
 
 
 In versions prior to `v1.12.0`, this interface resided in a different package, 
internal to the
-xref:ugvro.adoc[Restful Objects] viewer, and defined a slightly different 
signature that used an internal enum:
+xref:../ugvro/ugvro.adoc[Restful Objects] viewer, and defined a slightly 
different signature that used an internal enum:
 
 [source,java]
 ----

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_EmailNotificationService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_EmailNotificationService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_EmailNotificationService.adoc
index 1bab3a1..03aa19d 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_EmailNotificationService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_EmailNotificationService.adoc
@@ -6,7 +6,7 @@
 
 
 
-The `EmailNotificationService` supports the 
xref:ugvw.adoc#_ugvw_features_user-registration[user registration] (self 
sign-up) features of the xref:ugvw.adoc#[Wicket viewer] whereby a user can 
sign-up to access an application by providing a valid email address.
+The `EmailNotificationService` supports the 
xref:../ugvw/ugvw.adoc#_ugvw_features_user-registration[user registration] 
(self sign-up) features of the xref:../ugvw/ugvw.adoc#[Wicket viewer] whereby a 
user can sign-up to access an application by providing a valid email address.
 
 The Wicket viewer will check whether an implementation of this service (and 
also the 
xref:../rgsvc/rgsvc.adoc#_rgsvc_spi_UserRegistrationService[`UserRegistrationService`])
 is available, and if so will (unless configured not to) expose a sign-up page 
where the user enters their email address. A verification email is sent using 
this service; the email includes a link back to the running application. The 
user then completes the registration process (choosing a user name, password 
and so on) and the Wicket viewer creates an account for them (using the 
aforementioned `UserRegistrationService`).
 
@@ -50,7 +50,7 @@ The text of these email templates is hard-coded as resources, 
in other words bak
 
 If you have configured an alternative email service implementation, it should 
process the message body as HTML.
 
-If you wish to write an alternative implementation of this service, note that 
(unlike most Apache Isis domain services) the implementation is also 
instantiated and injected by Google Guice. This is because 
`EmailNotificationService` is used as part of the 
xref:ugvw.adoc#_ugvw_features_user-registration[user registration] 
functionality and is used by Wicket pages that are accessed outside of the 
usual Apache Isis runtime.
+If you wish to write an alternative implementation of this service, note that 
(unlike most Apache Isis domain services) the implementation is also 
instantiated and injected by Google Guice. This is because 
`EmailNotificationService` is used as part of the 
xref:../ugvw/ugvw.adoc#_ugvw_features_user-registration[user registration] 
functionality and is used by Wicket pages that are accessed outside of the 
usual Apache Isis runtime.
 
 This implies a couple of additional constraints:
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ExceptionRecognizer.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ExceptionRecognizer.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ExceptionRecognizer.adoc
index 85db100..af737f5 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ExceptionRecognizer.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_ExceptionRecognizer.adoc
@@ -69,7 +69,7 @@ public interface ExceptionRecognizer2 ... {
 <6> recognized, but uncategorized (typically: a recognizer of the original 
`ExceptionRecognizer` API).
 
 
-In essence, if an exception is recognized then it is also categorized.  This 
lets the viewer act accordingly.  For example, if an exception is raised from 
the loading of an individual object, then this is passed by the registered 
``ExceptionRecognizer``s. If any of these recognize the exception as 
representing a not-found exception, then an Apache Isis 
`ObjectNotFoundException` is raised. Both the viewers interprets this correctly 
(the xref:ugvw.adoc#[Wicket viewer] as a suitable error page, the 
xref:ugvro.adoc#[Restful Objects viewer] as a 404 status return code).
+In essence, if an exception is recognized then it is also categorized.  This 
lets the viewer act accordingly.  For example, if an exception is raised from 
the loading of an individual object, then this is passed by the registered 
``ExceptionRecognizer``s. If any of these recognize the exception as 
representing a not-found exception, then an Apache Isis 
`ObjectNotFoundException` is raised. Both the viewers interprets this correctly 
(the xref:../ugvw/ugvw.adoc#[Wicket viewer] as a suitable error page, the 
xref:../ugvro/ugvro.adoc#[Restful Objects viewer] as a 404 status return code).
 
 
 If the implementation recognizes the exception then it returns a user-friendly 
message to be rendered (by the viewer) back to the user; otherwise it returns 
`null`. There is no need for the implementation to check for exception causes; 
the casual chain is unwrapped by Apache Isis core and each exception in the 
chain will also be passed through to the recognizer (from most specific to 
least). The recognizer implementation can therefore be as fine-grained or as 
coarse-grained as it wishes.

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_GridSystemService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_GridSystemService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_GridSystemService.adoc
index d610cee..523bea6 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_GridSystemService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_GridSystemService.adoc
@@ -55,7 +55,7 @@ the service with the lowest 
xref:../rgant/rgant.adoc#_rgant-DomainServiceLayout_
 == Implementation
 
 The framework provides `GridSystemServiceBS3`, an implementation that encodes 
the bootstrap3 grid system.  (The framework
-also provides xref:ugvw.adoc[Wicket viewer] components that are capable of 
interpreting and rendering this metadata).
+also provides xref:../ugvw/ugvw.adoc[Wicket viewer] components that are 
capable of interpreting and rendering this metadata).
 
 
 == Registering the Services

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_HintStore.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_HintStore.adoc 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_HintStore.adoc
index 34bfcca..6d172d2 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_HintStore.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_HintStore.adoc
@@ -5,7 +5,7 @@
 :_imagesdir: images/
 
 
-The `HintStore` service defines an SPI for the xref:ugvw.adoc#[Wicket viewer] 
to store UI hints on a per-object basis.
+The `HintStore` service defines an SPI for the xref:../ugvw/ugvw.adoc#[Wicket 
viewer] to store UI hints on a per-object basis.
 For example, the viewer remembers which tabs are selected, and for collections 
which view is selected (eg table or hidden),
 which page of a table to render, or whether "show all" (rows) is toggled.
 
@@ -59,6 +59,6 @@ in the 
xref:../rgsvc/rgsvc.adoc#__rgsvc_intro_overriding-the-services[introducti
 
 == Related Services
 
-The xref:ugvw.adoc[Wicket viewer] exposes the 
xref:../rgcms/rgcms.adoc#__rgcms_classes_mixins_Object_clearHints["clear hints"]
+The xref:../ugvw/ugvw.adoc[Wicket viewer] exposes the 
xref:../rgcms/rgcms.adoc#__rgcms_classes_mixins_Object_clearHints["clear hints"]
 mixin action that is for use by end-users of the application to clear any UI 
hints that have accumulated for a
 domain object.

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_LocaleProvider.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_LocaleProvider.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_LocaleProvider.adoc
index a31b079..2167d64 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_LocaleProvider.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_LocaleProvider.adoc
@@ -13,7 +13,7 @@ The role of the service itself is simply to return the 
`Locale` of the current u
 
 [NOTE]
 ====
-For the "big picture" and further details on Apache Isis' i18n support, see 
xref:ugbtb.adoc#_ugbtb_i18n[here].
+For the "big picture" and further details on Apache Isis' i18n support, see 
xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[here].
 ====
 
 
@@ -37,11 +37,11 @@ This is notionally request-scoped, returning the `Locale` 
of the current user; _
 
 == Implementation
 
-Isis' xref:ugvw.adoc#[Wicket viewer] provides an implementation of this 
service (`LocaleProviderWicket`) which leverages Apache Wicket APIs.
+Isis' xref:../ugvw/ugvw.adoc#[Wicket viewer] provides an implementation of 
this service (`LocaleProviderWicket`) which leverages Apache Wicket APIs.
 
 [NOTE]
 ====
-Currently there is no equivalent implementation for the 
xref:ugvro.adoc#[RestfulObjects viewer].
+Currently there is no equivalent implementation for the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer].
 ====
 
 
@@ -51,7 +51,7 @@ Currently there is no equivalent implementation for the 
xref:ugvro.adoc#[Restful
 
 Assuming that the `configuration-and-annotation` services installer is 
configured (implicit if using the
 `AppManifest` to 
xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the 
app]), __and__ that the
-xref:ugvw.adoc#[Wicket viewer] is being used, then an implementation of 
`LocaleProvider` is
+xref:../ugvw/ugvw.adoc#[Wicket viewer] is being used, then an implementation 
of `LocaleProvider` is
 automatically registered and injected (it is annotated with `@DomainService`) 
so no further configuration is required.
 
 To use an alternative implementation, use

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublisherService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublisherService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublisherService.adoc
index fa65e0e..192638f 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublisherService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublisherService.adoc
@@ -120,7 +120,7 @@ the `pom.xml` and updating the `AppManifest#getModules()` 
method.
 
 The module also provide services that contribute to the UI.  If contributions 
are not required in the UI, these can be
 suppressed either using security or by implementing a
-xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing subscriber].
+xref:../ugbtb/ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublishingService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublishingService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublishingService.adoc
index 7897e4f..f64091a 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublishingService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_PublishingService.adoc
@@ -160,7 +160,7 @@ the `pom.xml` and updating the `AppManifest#getModules()` 
method.
 
 The module also provides services that contribute to the UI.  If contributions 
are not required in the UI, these can be
 suppressed either using security or by implementing a
-xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing subscriber].
+xref:../ugbtb/ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_RoutingService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_RoutingService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_RoutingService.adoc
index 899f379..6876445 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_RoutingService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_RoutingService.adoc
@@ -20,7 +20,7 @@ of the implementation to figure out what the "owning" object 
might be.
 +
 For example, return the home page (eg as defined by the 
xref:../rgant/rgant.adoc#_rgant-HomePage[`@HomePage`] annotation).
 
-Currently the routing service is used only by the xref:ugvw.adoc#[Wicket 
viewer]; it is ignored by the xref:ugvro.adoc#[Restful Objects] viewer.
+Currently the routing service is used only by the 
xref:../ugvw/ugvw.adoc#[Wicket viewer]; it is ignored by the 
xref:../ugvro/ugvro.adoc#[Restful Objects] viewer.
 
 
 [NOTE]

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationService.adoc
index 451163c..16a713e 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationService.adoc
@@ -11,7 +11,7 @@ The `TranslationService` is the cornerstone of Apache Isis' 
i18n support.  Its r
 
 [NOTE]
 ====
-For the "big picture" and further details on Apache Isis' i18n support, see 
xref:ugbtb.adoc#_ugbtb_i18n[here].
+For the "big picture" and further details on Apache Isis' i18n support, see 
xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[here].
 ====
 
 
@@ -53,7 +53,7 @@ The Apache Isis framework provides a default implementation 
(`TranslationService
 
 The framework also provides a supporting `TranslationServicePoMenu` provides 
menu items under the "Prototyping" secondary menu for controlling this service 
and downloading `.pot` files for translation.
 
-For more details on the implementation, see xref:ugbtb.adoc#_ugbtb_i18n[i18n 
support].
+For more details on the implementation, see 
xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[i18n support].
 
 
 
@@ -64,7 +64,7 @@ Assuming that the `configuration-and-annotation` services 
installer is configure
 `AppManifest` to 
xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the 
app]) then Apache Isis' core
 implementation of `TranslationService` service (along with the supporting menu 
service) are automatically registered and injected (it is annotated with 
`@DomainService`) so no further configuration is required.
 
-If the menu items are not required then these can be suppressed either using 
security or by implementing a 
xref:ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing subscriber].
+If the menu items are not required then these can be suppressed either using 
security or by implementing a 
xref:../ugbtb/ugbtb.adoc#_ugbtb_decoupling_vetoing-visibility[vetoing 
subscriber].
 
 To use an alternative implementation, use
 
xref:../rgant/rgant.adoc#_rgant-DomainServiceLayout_menuOrder[`@DomainServiceLayout#menuOrder()`]
 (as explained

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationsResolver.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationsResolver.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationsResolver.adoc
index 2c14678..7c55660 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationsResolver.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_TranslationsResolver.adoc
@@ -13,7 +13,7 @@ The role of the service itself is locate and return 
translations.
 
 [NOTE]
 ====
-For the "big picture" and further details on Apache Isis' i18n support, see 
xref:ugbtb.adoc#_ugbtb_i18n[here].
+For the "big picture" and further details on Apache Isis' i18n support, see 
xref:../ugbtb/ugbtb.adoc#_ugbtb_i18n[here].
 ====
 
 
@@ -33,11 +33,11 @@ public interface TranslationsResolver {
 
 == Implementation
 
-Isis' xref:ugvw.adoc#[Wicket viewer] provides an implementation of this 
service (`TranslationsResolverWicket`) which leverages Apache Wicket APIs.  
This searches for translation files in the standard `WEB-INF/` directory.
+Isis' xref:../ugvw/ugvw.adoc#[Wicket viewer] provides an implementation of 
this service (`TranslationsResolverWicket`) which leverages Apache Wicket APIs. 
 This searches for translation files in the standard `WEB-INF/` directory.
 
 [NOTE]
 ====
-Currently there is no equivalent implementation for the 
xref:ugvro.adoc#[RestfulObjects viewer].
+Currently there is no equivalent implementation for the 
xref:../ugvro/ugvro.adoc#[RestfulObjects viewer].
 ====
 
 
@@ -47,7 +47,7 @@ Currently there is no equivalent implementation for the 
xref:ugvro.adoc#[Restful
 == Registering the Service
 
 Assuming that the `configuration-and-annotation` services installer is 
configured (implicit if using the
-`AppManifest` to 
xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the 
app]), _and_ that the xref:ugvw.adoc#[Wicket viewer] is being used, then an 
implementation of `TranslationsResolver` is
+`AppManifest` to 
xref:../rgcms/rgcms.adoc#_rgcms_classes_AppManifest-bootstrapping[bootstrap the 
app]), _and_ that the xref:../ugvw/ugvw.adoc#[Wicket viewer] is being used, 
then an implementation of `TranslationsResolver` is
 automatically registered and injected (it is annotated with `@DomainService`) 
so no further configuration is required.
 
 To use an alternative implementation, use

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UrlEncodingService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UrlEncodingService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UrlEncodingService.adoc
index 1f5efbc..05f948c 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UrlEncodingService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UrlEncodingService.adoc
@@ -7,7 +7,7 @@
 
 
 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]
+within a URL.  The service is used by the framework to map 
xref:../ugbtb/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
 view model memento, from which the view model can then be hydrated.

http://git-wip-us.apache.org/repos/asf/isis/blob/b2b87ca4/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UserProfileService.adoc
----------------------------------------------------------------------
diff --git 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UserProfileService.adoc
 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UserProfileService.adoc
index 9b1add5..67188bd 100644
--- 
a/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UserProfileService.adoc
+++ 
b/adocs/documentation/src/main/asciidoc/guides/rgsvc/_rgsvc_spi_UserProfileService.adoc
@@ -6,7 +6,7 @@
 
 
 
-The `UserProfileService` provides the ability for the domain application to 
return supplementary metadata about the current user. This information is used 
(by the xref:ugvw.adoc#[Wicket viewer]) to customize the appearance of the 
tertiary "Me" menu bar (top right). For example, rather than display the 
username, instead the user's first and last name could be displayed.
+The `UserProfileService` provides the ability for the domain application to 
return supplementary metadata about the current user. This information is used 
(by the xref:../ugvw/ugvw.adoc#[Wicket viewer]) to customize the appearance of 
the tertiary "Me" menu bar (top right). For example, rather than display the 
username, instead the user's first and last name could be displayed.
 
 Another use case is to allow the user to switch context in some fashion or 
other. This might be to emulate a sort of "sudo"-like function, or perhaps to 
focus on some particular set of data.
 

Reply via email to