You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2020/01/26 15:57:36 UTC

[isis] 01/14: ISIS-2062: removes stale javadoc for HealthCheckService

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

danhaywood pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git

commit e1524530ea8ecf3456c9bf5942ea33472e75d09b
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Sun Jan 26 14:46:38 2020 +0000

    ISIS-2062: removes stale javadoc for HealthCheckService
---
 .../modules/applib-cm/examples/layout/package-info.java   |  2 +-
 .../applib-cm/examples/mixins/dto/package-info.java       |  2 +-
 .../examples/services/appfeat/package-info.java           |  2 +-
 .../applib-svc/examples/services/audit/package-info.java  |  2 +-
 .../examples/services/background/package-info.java        |  2 +-
 .../examples/services/bookmark/package-info.java          |  2 +-
 .../applib-svc/examples/services/clock/package-info.java  |  2 +-
 .../examples/services/command/package-info.java           |  2 +-
 .../examples/services/confview/package-info.java          |  2 +-
 .../applib-svc/examples/services/conmap/package-info.java |  2 +-
 .../applib-svc/examples/services/email/package-info.java  |  2 +-
 .../applib-svc/examples/services/error/package-info.java  |  2 +-
 .../examples/services/eventbus/package-info.java          |  2 +-
 .../examples/services/exceprecog/package-info.java        |  2 +-
 .../examples/services/factory/package-info.java           |  2 +-
 .../applib-svc/examples/services/grid/package-info.java   |  2 +-
 .../applib-svc/examples/services/hint/package-info.java   |  2 +-
 .../applib-svc/examples/services/i18n/package-info.java   |  2 +-
 .../applib-svc/examples/services/iactn/package-info.java  |  2 +-
 .../applib-svc/examples/services/jaxb/package-info.java   |  2 +-
 .../applib-svc/examples/services/layout/package-info.java |  2 +-
 .../examples/services/linking/package-info.java           |  2 +-
 .../examples/services/message/package-info.java           |  2 +-
 .../examples/services/metamodel/package-info.java         |  2 +-
 .../examples/services/metrics/package-info.java           |  2 +-
 .../examples/services/publish/package-info.java           |  2 +-
 .../examples/services/queryresultscache/package-info.java |  2 +-
 .../examples/services/registry/package-info.java          |  2 +-
 .../examples/services/repository/package-info.java        |  2 +-
 .../examples/services/routing/package-info.java           |  2 +-
 .../examples/services/scratchpad/package-info.java        |  2 +-
 .../examples/services/sessmgmt/package-info.java          |  2 +-
 .../applib-svc/examples/services/sudo/package-info.java   |  2 +-
 .../examples/services/swagger/package-info.java           |  2 +-
 .../applib-svc/examples/services/title/package-info.java  |  2 +-
 .../examples/services/urlencoding/package-info.java       |  2 +-
 .../applib-svc/examples/services/user/package-info.java   |  2 +-
 .../examples/services/userprof/package-info.java          |  2 +-
 .../examples/services/userreg/package-info.java           |  2 +-
 .../examples/services/wrapper/events/package-info.java    |  2 +-
 .../examples/services/wrapper/package-info.java           |  2 +-
 .../applib-svc/examples/services/xactn/package-info.java  |  2 +-
 .../examples/services/xmlsnapshot/package-info.java       |  2 +-
 .../pages/application-layer-spi/HealthCheckService.adoc   |  7 ++++++-
 .../java/org/apache/isis/applib/annotation/HomePage.java  | 15 ++++++---------
 .../java/org/apache/isis/applib/layout/package-info.java  |  2 +-
 .../org/apache/isis/applib/mixins/dto/package-info.java   |  2 +-
 .../apache/isis/applib/services/appfeat/package-info.java |  2 +-
 .../apache/isis/applib/services/audit/package-info.java   |  2 +-
 .../isis/applib/services/background/package-info.java     |  2 +-
 .../isis/applib/services/bookmark/package-info.java       |  2 +-
 .../apache/isis/applib/services/clock/package-info.java   |  2 +-
 .../apache/isis/applib/services/command/package-info.java |  2 +-
 .../isis/applib/services/confview/package-info.java       |  2 +-
 .../apache/isis/applib/services/conmap/package-info.java  |  2 +-
 .../apache/isis/applib/services/email/package-info.java   |  2 +-
 .../apache/isis/applib/services/error/package-info.java   |  2 +-
 .../isis/applib/services/eventbus/package-info.java       |  2 +-
 .../isis/applib/services/exceprecog/package-info.java     |  2 +-
 .../apache/isis/applib/services/factory/package-info.java |  2 +-
 .../apache/isis/applib/services/grid/package-info.java    |  2 +-
 .../isis/applib/services/health/HealthCheckService.java   |  3 ---
 .../apache/isis/applib/services/hint/package-info.java    |  2 +-
 .../apache/isis/applib/services/i18n/package-info.java    |  2 +-
 .../apache/isis/applib/services/iactn/package-info.java   |  2 +-
 .../apache/isis/applib/services/jaxb/package-info.java    |  2 +-
 .../apache/isis/applib/services/layout/package-info.java  |  2 +-
 .../apache/isis/applib/services/linking/package-info.java |  2 +-
 .../apache/isis/applib/services/message/package-info.java |  2 +-
 .../isis/applib/services/metamodel/package-info.java      |  2 +-
 .../apache/isis/applib/services/metrics/package-info.java |  2 +-
 .../apache/isis/applib/services/publish/package-info.java |  2 +-
 .../applib/services/queryresultscache/package-info.java   |  2 +-
 .../isis/applib/services/registry/package-info.java       |  2 +-
 .../isis/applib/services/repository/package-info.java     |  2 +-
 .../apache/isis/applib/services/routing/package-info.java |  2 +-
 .../isis/applib/services/scratchpad/package-info.java     |  2 +-
 .../isis/applib/services/sessmgmt/package-info.java       |  2 +-
 .../apache/isis/applib/services/sudo/package-info.java    |  2 +-
 .../apache/isis/applib/services/swagger/package-info.java |  2 +-
 .../apache/isis/applib/services/title/package-info.java   |  2 +-
 .../isis/applib/services/urlencoding/package-info.java    |  2 +-
 .../apache/isis/applib/services/user/package-info.java    |  2 +-
 .../isis/applib/services/userprof/package-info.java       |  2 +-
 .../apache/isis/applib/services/userreg/package-info.java |  2 +-
 .../isis/applib/services/wrapper/events/package-info.java |  2 +-
 .../apache/isis/applib/services/wrapper/package-info.java |  2 +-
 .../apache/isis/applib/services/xactn/package-info.java   |  2 +-
 .../isis/applib/services/xmlsnapshot/package-info.java    |  2 +-
 89 files changed, 98 insertions(+), 99 deletions(-)

diff --git a/api/applib/src/main/adoc/modules/applib-cm/examples/layout/package-info.java b/api/applib/src/main/adoc/modules/applib-cm/examples/layout/package-info.java
index f67a4e4..fd2748d 100644
--- a/api/applib/src/main/adoc/modules/applib-cm/examples/layout/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-cm/examples/layout/package-info.java
@@ -20,6 +20,6 @@
 /**
  * Support for file-based layouts.
  *
- * @see <a href="http://isis.apache.org/guides/ugvw/ugvw.html#_ugvw_layout_file-based">User guide</a>
+ *
  */
 package org.apache.isis.applib.layout;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-cm/examples/mixins/dto/package-info.java b/api/applib/src/main/adoc/modules/applib-cm/examples/mixins/dto/package-info.java
index b5f3b54..a9f404b 100644
--- a/api/applib/src/main/adoc/modules/applib-cm/examples/mixins/dto/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-cm/examples/mixins/dto/package-info.java
@@ -23,6 +23,6 @@
  * XSD schema of those objects using two mixins, {@link org.apache.isis.applib.mixins.dto.Dto_downloadXml} and
  * {@link org.apache.isis.applib.mixins.dto.Dto_downloadXsd}.
  *
- * @see <a href="http://isis.apache.org/guides/rgcms/rgcms.html#_rgcms_classes_mixins_Dto">Classes, Methods &amp; Schema guide</a>
+ *
  */
 package org.apache.isis.applib.mixins.dto;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/appfeat/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/appfeat/package-info.java
index 6b85775..23f328b 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/appfeat/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/appfeat/package-info.java
@@ -22,6 +22,6 @@
  * representations of the packages, classes and class members (collectively: "application features") of the
  * domain classes within the Apache Isis' internal metamodel.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_ApplicationFeatureRepository">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.appfeat;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/audit/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/audit/package-info.java
index 1018861..9cae3a2 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/audit/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/audit/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.audit.AuditerService} auditing service provides a simple mechanism to
  * capture changes to data. It is called for each property that has changed on any domain object, as a set of pre- and post-values.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_AuditerService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.audit;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/background/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/background/package-info.java
index 3527101..f63812d 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/background/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/background/package-info.java
@@ -22,6 +22,6 @@
  * {@link org.apache.isis.applib.services.background.BackgroundCommandService2} SPI service, enable commands to be
  * persisted such that they may be invoked in the background
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_BackgroundService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.background;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/bookmark/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/bookmark/package-info.java
index 9915bc7..6c3c413 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/bookmark/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/bookmark/package-info.java
@@ -22,6 +22,6 @@
  * serializable {@link org.apache.isis.applib.services.bookmark.Bookmark} for any (persisted) domain object, and to
  * lookup domain objects given a Bookmark. This can then in turn be converted to and from a string.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_BookmarkService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.bookmark;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/clock/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/clock/package-info.java
index c87f8d5..9f26221 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/clock/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/clock/package-info.java
@@ -20,6 +20,6 @@
 /**
  * This domain service provides current time.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_ClockService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.clock;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/command/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/command/package-info.java
index e769c49..99c057a 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/command/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/command/package-info.java
@@ -22,6 +22,6 @@
  * the invocation of an action on a domain object into an object itself. This reified information is encapsulated
  * within the {@link org.apache.isis.applib.services.command.Command} object.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_CommandContext">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.command;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/confview/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/confview/package-info.java
index f54a267..9a44951 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/confview/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/confview/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.confview.ConfigurationViewService} allows domain objects to read the
  * configuration properties aggregated from the various configuration files.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_ConfigurationService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.confview;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/conmap/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/conmap/package-info.java
index 0df8fdd..3d346b3 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/conmap/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/conmap/package-info.java
@@ -22,6 +22,6 @@
  * <code>ContentNegotiationService</code> enabling the RestfulObjects viewer to represent domain objects in some other
  * format as specified by the HTTP <code>Accept</code> header.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService">Reference Guide</a>
+ *
  */
 package org.apache.isis.applib.services.conmap;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/email/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/email/package-info.java
index 27573af..8871910 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/email/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/email/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.email.EmailService} provides the ability to send HTML emails, with
  * attachments, to one or more recipients.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_EmailService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.email;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/error/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/error/package-info.java
index 48c9cf2..eb7531b 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/error/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/error/package-info.java
@@ -23,6 +23,6 @@
  * system (such as JIRA). The service also allows a user-friendly (jargon-free) error message to be returned and
  * rendered to the end.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ErrorReportingService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.error;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/eventbus/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/eventbus/package-info.java
index 34a4e86..8d79227 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/eventbus/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/eventbus/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.eventbus.EventBusService} allows domain objects to emit events to
  * subscribing domain services using an in-memory event bus.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_EventBusService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.eventbus;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/exceprecog/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/exceprecog/package-info.java
index c10819d..ef40d73 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/exceprecog/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/exceprecog/package-info.java
@@ -23,6 +23,6 @@
  * thrown by the system. Rather than display an obscure error to the end-user, the application can instead display a
  * user-friendly message
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ExceptionRecognizer">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.exceprecog;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/factory/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/factory/package-info.java
index 73a92f3..35e07de 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/factory/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/factory/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.factory.FactoryService} collects together methods for instantiating
  * domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_FactoryService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.factory;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/grid/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/grid/package-info.java
index 52e28c3..50e7826 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/grid/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/grid/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.grid.GridService} encapsulates a single layout grid system which
  * can be used to customize the layout of domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_GridService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.grid;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/hint/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/hint/package-info.java
index f282009..18ca5c6 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/hint/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/hint/package-info.java
@@ -23,6 +23,6 @@
  * which view is selected (eg table or hidden), which page of a table to render, or whether "show all" (rows) is
  * toggled.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_HintStore">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.hint;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/i18n/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/i18n/package-info.java
index 0da990c..bb1aacc 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/i18n/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/i18n/package-info.java
@@ -23,6 +23,6 @@
  * (service and object classes, properties, collections, actions, action parameters) and also to translate business
  * rule (disable/valid) messages, and exceptions. These translations provide for both singular and plural forms.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_TranslationService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.i18n;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/iactn/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/iactn/package-info.java
index 2bbbd04..f0cc5eb 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/iactn/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/iactn/package-info.java
@@ -24,6 +24,6 @@
  * a property. If that top-level action or property uses the {@link org.apache.isis.applib.services.wrapper.WrapperFactory} to invoke child actions/properties, then
  * those sub-executions are captured as a call-graph. The Execution is thus a graph structure.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#__code_interactioncontext_code">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.iactn;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/jaxb/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/jaxb/package-info.java
index 4114194..a3145e8 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/jaxb/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/jaxb/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.jaxb.JaxbService} allows instances of JAXB-annotated classes to be
  * marshalled to XML and unmarshalled from XML back into domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_JaxbService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.jaxb;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/layout/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/layout/package-info.java
index f387656..f38038e 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/layout/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/layout/package-info.java
@@ -22,6 +22,6 @@
  * for a single domain object or for all domain objects. This functionality is surfaced through the user interface
  * through a related mixin and menu action.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_LayoutService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.layout;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/linking/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/linking/package-info.java
index e51f557..d292d51 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/linking/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/linking/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.linking.DeepLinkService} provides the ability to obtain a
  * <code>java.net.URI</code> that links to a representation of any (persisted) domain entity or view model.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-api_DeepLinkService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.linking;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/message/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/message/package-info.java
index cf699a6..f70f8f6 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/message/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/message/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.message.MessageService} allows domain objects to raise information,
  * warning or error messages. These messages can either be simple strings, or can be translated.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_MessageService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.message;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/metamodel/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/metamodel/package-info.java
index a548d89..4be56f7 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/metamodel/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/metamodel/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.metamodel.MetaModelService} service provides access to a number of
  * aspects of Apache Isis' internal metamodel.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_MetamodelService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.metamodel;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/metrics/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/metrics/package-info.java
index e93d3cd..0422a81 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/metrics/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/metrics/package-info.java
@@ -22,6 +22,6 @@
  * into the JDO/DataNucleus ObjectStore to provide a number of counters relating to numbers of object loaded,
  * dirtied etc.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_MetricsService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.metrics;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/publish/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/publish/package-info.java
index 37bc385..e731579 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/publish/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/publish/package-info.java
@@ -23,6 +23,6 @@
  * published are action invocations/property edits, and changed objects. A typical use case is to publish onto a
  * pub/sub bus such as ActiveMQ with Camel to keep other systems up to date.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_PublisherService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.publish;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/queryresultscache/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/queryresultscache/package-info.java
index 290f779..3e6485f 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/queryresultscache/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/queryresultscache/package-info.java
@@ -22,6 +22,6 @@
  * response times to the user, by providing a request-scoped cache of the value of some (safe or idempotent) method
  * call. This will typically be as the result of running a query, but could be any expensive operation.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_QueryResultsCache">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.queryresultscache;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/registry/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/registry/package-info.java
index 9d6da01..9c15400 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/registry/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/registry/package-info.java
@@ -22,6 +22,6 @@
  * or looking up domain services (either provided by the framework or application-specific) currently known to the
  * runtime.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_ServiceRegistry">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.registry;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/repository/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/repository/package-info.java
index aa4cb8a..67603ba 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/repository/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/repository/package-info.java
@@ -22,6 +22,6 @@
  * persisting and searching for entities from the underlying persistence store. It acts as an abstraction over the
  * JDO/DataNucleus objectstore.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_RepositoryService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.repository;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/routing/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/routing/package-info.java
index ca4abd2..dc9c7f0 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/routing/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/routing/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.routing.RoutingService} provides the ability to return (and therefore
  * render) an alternative object from an action invocation.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_RoutingService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.routing;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/scratchpad/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/scratchpad/package-info.java
index b121297..66501bf 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/scratchpad/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/scratchpad/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.scratchpad.Scratchpad} (request-scoped) domain service allows objects to
  * exchange information even if they do not directly call each other.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_Scratchpad">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.scratchpad;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/sessmgmt/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/sessmgmt/package-info.java
index c9edede..7527d77 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/sessmgmt/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/sessmgmt/package-info.java
@@ -23,6 +23,6 @@
  * from the UI and which create or modify large amounts of data. A classic example is migrating data from one system
  * to another.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_SessionManagementService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.sessmgmt;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/sudo/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/sudo/package-info.java
index 2b8fae9..8d64ee6 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/sudo/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/sudo/package-info.java
@@ -24,6 +24,6 @@
  * another) and while running fixture scripts (eg setting up objects that would normally require several users to have
  * acted upon the objects).
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_testing_SudoService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.sudo;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/swagger/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/swagger/package-info.java
index 4a2a3fd..4a80b28 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/swagger/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/swagger/package-info.java
@@ -21,6 +21,6 @@
  * The {@link SwaggerService} generates Swagger schema definition files to describe the public and/or private
  * RESTful APIs exposed by the RestfulObjects viewer.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_SwaggerService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.swagger;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/title/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/title/package-info.java
index 112ae2d..dd5921a 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/title/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/title/package-info.java
@@ -20,6 +20,6 @@
 /**
  * The {@link org.apache.isis.applib.services.title.TitleService} provides methods to programmatically obtain the title and icon of a domain object.
 
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_TitleService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.title;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/urlencoding/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/urlencoding/package-info.java
index d6a695c..fa9add3 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/urlencoding/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/urlencoding/package-info.java
@@ -24,6 +24,6 @@
  * invoke an action on it), this URL is converted back into a view model memento, from which the view model can then
  * be hydrated
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_UrlEncodingService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.urlencoding;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/user/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/user/package-info.java
index b9e2a8a..36c8fc4 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/user/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/user/package-info.java
@@ -20,6 +20,6 @@
 /**
  * The {@link UserService} allows the domain object to obtain the identity of the user interacting with said object.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_UserService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.user;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/userprof/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/userprof/package-info.java
index ed5b3c0..ac15bb5 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/userprof/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/userprof/package-info.java
@@ -23,6 +23,6 @@
  * 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.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_UserProfileService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.userprof;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/userreg/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/userreg/package-info.java
index e508ab6..4499bb7 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/userreg/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/userreg/package-info.java
@@ -22,6 +22,6 @@
  * sign-up to access an application by providing a valid email address, and also provides the capability for users to
  * reset their password if forgotten.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_UserRegistrationService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.userreg;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/events/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/events/package-info.java
index 903da7a..f3f45ab 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/events/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/events/package-info.java
@@ -21,6 +21,6 @@
  * Interaction events, corresponding to gestures in the user interface; emitted only by the
  * {@link org.apache.isis.applib.services.wrapper.WrapperFactory}.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_WrapperFactory">Reference Guide</a>
+ *
  */
 package org.apache.isis.applib.services.wrapper.events;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/package-info.java
index 86186a0..14f02ea 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/wrapper/package-info.java
@@ -23,6 +23,6 @@
  * and callee — eg if they reside in different modules — then the wrapper factory is a useful mechanism to ensure that
  * any business constraints defined by the callee are honoured.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_WrapperFactory">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.wrapper;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/xactn/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/xactn/package-info.java
index d961f24..266659f 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/xactn/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/xactn/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.xactn.TransactionService} provides a small number of methods to allow
  * domain objects to influence user transactions.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_TransactionService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.xactn;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/examples/services/xmlsnapshot/package-info.java b/api/applib/src/main/adoc/modules/applib-svc/examples/services/xmlsnapshot/package-info.java
index e5e2cab..8a5ef39 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/examples/services/xmlsnapshot/package-info.java
+++ b/api/applib/src/main/adoc/modules/applib-svc/examples/services/xmlsnapshot/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.xmlsnapshot.XmlSnapshotService} provides the capability to generate
  * XML snapshots (and if required corresponding XSD schemas) based on graphs of domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_XmlSnapshotService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.xmlsnapshot;
\ No newline at end of file
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/application-layer-spi/HealthCheckService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/application-layer-spi/HealthCheckService.adoc
index b834829..446e38c 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/application-layer-spi/HealthCheckService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/application-layer-spi/HealthCheckService.adoc
@@ -1,9 +1,14 @@
-[[HealthCheckService]]
 = `HealthCheckService`
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 :page-partial:
 
 
+This service integrates with Spring Boot's link:https://docs.spring.io/spring-boot/docs/current/api/org/springframework/boot/actuate/health/HealthIndicator.html[HealthIndicator] SPI, surfaced through the link:https://docs.spring.io/spring-boot/docs/current/reference/html/production-ready-features.html[Spring Boot Actuator].
+
+WARNING: TODO: v2: update - rest of this documentation is out of date.
+
+
+
 
 This service, if implemented, is used to performs a health check to determine if the application is still available.
 The results of this service are made available through a REST resource, typically mounted at `/restful/health`.
diff --git a/api/applib/src/main/java/org/apache/isis/applib/annotation/HomePage.java b/api/applib/src/main/java/org/apache/isis/applib/annotation/HomePage.java
index 05b4954..9bad1d7 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/annotation/HomePage.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/annotation/HomePage.java
@@ -28,19 +28,16 @@ import java.lang.annotation.Target;
 import org.apache.isis.applib.ViewModel;
 
 /**
- * Indicates that the (no-arg) action (on a domain service) to be invoked automatically
- * and the contents used for the home page.
+ * Annotated on a view model to indicate that it should be used as the home page.
  *
  * <p>
- * Typically this action would return a {@link ViewModel} representing a dashboard
- * (from which the user can navigate to commonly used objects and invoked actions);
- * it might also simply invoke an action that returns a list.
- * <p>
- * Might also be placed on a type typically a {@link ViewModel} to be used as the home page.
- * 
+ *     The view model is instantiated through a no-arg constructor, so must in effect be stateless.
+ *     Typically it will use injected repositories in order to display a dashboard, and offer actions
+ *     to traverse or operate on the rendered state.
+ * </p>
  */
 @Inherited
-@Target({ ElementType.METHOD, ElementType.TYPE })
+@Target({ ElementType.TYPE })
 @Retention(RetentionPolicy.RUNTIME)
 public @interface HomePage {
 }
diff --git a/api/applib/src/main/java/org/apache/isis/applib/layout/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/layout/package-info.java
index f67a4e4..fd2748d 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/layout/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/layout/package-info.java
@@ -20,6 +20,6 @@
 /**
  * Support for file-based layouts.
  *
- * @see <a href="http://isis.apache.org/guides/ugvw/ugvw.html#_ugvw_layout_file-based">User guide</a>
+ *
  */
 package org.apache.isis.applib.layout;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/mixins/dto/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/mixins/dto/package-info.java
index b5f3b54..a9f404b 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/mixins/dto/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/mixins/dto/package-info.java
@@ -23,6 +23,6 @@
  * XSD schema of those objects using two mixins, {@link org.apache.isis.applib.mixins.dto.Dto_downloadXml} and
  * {@link org.apache.isis.applib.mixins.dto.Dto_downloadXsd}.
  *
- * @see <a href="http://isis.apache.org/guides/rgcms/rgcms.html#_rgcms_classes_mixins_Dto">Classes, Methods &amp; Schema guide</a>
+ *
  */
 package org.apache.isis.applib.mixins.dto;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java
index 6b85775..23f328b 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/appfeat/package-info.java
@@ -22,6 +22,6 @@
  * representations of the packages, classes and class members (collectively: "application features") of the
  * domain classes within the Apache Isis' internal metamodel.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_ApplicationFeatureRepository">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.appfeat;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java
index 1018861..9cae3a2 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/audit/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.audit.AuditerService} auditing service provides a simple mechanism to
  * capture changes to data. It is called for each property that has changed on any domain object, as a set of pre- and post-values.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_AuditerService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.audit;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java
index 3527101..f63812d 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/background/package-info.java
@@ -22,6 +22,6 @@
  * {@link org.apache.isis.applib.services.background.BackgroundCommandService2} SPI service, enable commands to be
  * persisted such that they may be invoked in the background
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_BackgroundService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.background;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java
index 9915bc7..6c3c413 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/bookmark/package-info.java
@@ -22,6 +22,6 @@
  * serializable {@link org.apache.isis.applib.services.bookmark.Bookmark} for any (persisted) domain object, and to
  * lookup domain objects given a Bookmark. This can then in turn be converted to and from a string.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_BookmarkService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.bookmark;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java
index c87f8d5..9f26221 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/clock/package-info.java
@@ -20,6 +20,6 @@
 /**
  * This domain service provides current time.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_ClockService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.clock;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java
index e769c49..99c057a 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/command/package-info.java
@@ -22,6 +22,6 @@
  * the invocation of an action on a domain object into an object itself. This reified information is encapsulated
  * within the {@link org.apache.isis.applib.services.command.Command} object.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_CommandContext">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.command;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/confview/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/confview/package-info.java
index f54a267..9a44951 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/confview/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/confview/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.confview.ConfigurationViewService} allows domain objects to read the
  * configuration properties aggregated from the various configuration files.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_ConfigurationService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.confview;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/conmap/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/conmap/package-info.java
index 0df8fdd..3d346b3 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/conmap/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/conmap/package-info.java
@@ -22,6 +22,6 @@
  * <code>ContentNegotiationService</code> enabling the RestfulObjects viewer to represent domain objects in some other
  * format as specified by the HTTP <code>Accept</code> header.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ContentMappingService">Reference Guide</a>
+ *
  */
 package org.apache.isis.applib.services.conmap;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java
index 27573af..8871910 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/email/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.email.EmailService} provides the ability to send HTML emails, with
  * attachments, to one or more recipients.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_EmailService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.email;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java
index 48c9cf2..eb7531b 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/error/package-info.java
@@ -23,6 +23,6 @@
  * system (such as JIRA). The service also allows a user-friendly (jargon-free) error message to be returned and
  * rendered to the end.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ErrorReportingService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.error;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java
index 34a4e86..8d79227 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/eventbus/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.eventbus.EventBusService} allows domain objects to emit events to
  * subscribing domain services using an in-memory event bus.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_EventBusService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.eventbus;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java
index c10819d..ef40d73 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/exceprecog/package-info.java
@@ -23,6 +23,6 @@
  * thrown by the system. Rather than display an obscure error to the end-user, the application can instead display a
  * user-friendly message
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_ExceptionRecognizer">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.exceprecog;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java
index 73a92f3..35e07de 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/factory/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.factory.FactoryService} collects together methods for instantiating
  * domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_FactoryService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.factory;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java
index 52e28c3..50e7826 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/grid/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.grid.GridService} encapsulates a single layout grid system which
  * can be used to customize the layout of domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_GridService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.grid;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/health/HealthCheckService.java b/api/applib/src/main/java/org/apache/isis/applib/services/health/HealthCheckService.java
index f197b5c..80c0adb 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/health/HealthCheckService.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/health/HealthCheckService.java
@@ -20,9 +20,6 @@ package org.apache.isis.applib.services.health;
 
 import org.apache.isis.applib.annotation.Programmatic;
 
-/**
- * SPI.  If implemented then <code>/restful/health</code> resource will invoke this service to determine the health of the system.
- */
 public interface HealthCheckService {
 
     @Programmatic
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java
index f282009..18ca5c6 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/hint/package-info.java
@@ -23,6 +23,6 @@
  * which view is selected (eg table or hidden), which page of a table to render, or whether "show all" (rows) is
  * toggled.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_HintStore">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.hint;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java
index 0da990c..bb1aacc 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/i18n/package-info.java
@@ -23,6 +23,6 @@
  * (service and object classes, properties, collections, actions, action parameters) and also to translate business
  * rule (disable/valid) messages, and exceptions. These translations provide for both singular and plural forms.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_TranslationService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.i18n;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java
index 2bbbd04..f0cc5eb 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/iactn/package-info.java
@@ -24,6 +24,6 @@
  * a property. If that top-level action or property uses the {@link org.apache.isis.applib.services.wrapper.WrapperFactory} to invoke child actions/properties, then
  * those sub-executions are captured as a call-graph. The Execution is thus a graph structure.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#__code_interactioncontext_code">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.iactn;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java
index 4114194..a3145e8 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/jaxb/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.jaxb.JaxbService} allows instances of JAXB-annotated classes to be
  * marshalled to XML and unmarshalled from XML back into domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_JaxbService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.jaxb;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java
index f387656..f38038e 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/layout/package-info.java
@@ -22,6 +22,6 @@
  * for a single domain object or for all domain objects. This functionality is surfaced through the user interface
  * through a related mixin and menu action.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_LayoutService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.layout;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java
index e51f557..d292d51 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/linking/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.linking.DeepLinkService} provides the ability to obtain a
  * <code>java.net.URI</code> that links to a representation of any (persisted) domain entity or view model.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-api_DeepLinkService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.linking;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java
index cf699a6..f70f8f6 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/message/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.message.MessageService} allows domain objects to raise information,
  * warning or error messages. These messages can either be simple strings, or can be translated.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_MessageService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.message;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java
index a548d89..4be56f7 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/metamodel/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.metamodel.MetaModelService} service provides access to a number of
  * aspects of Apache Isis' internal metamodel.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_MetamodelService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.metamodel;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java
index e93d3cd..0422a81 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/metrics/package-info.java
@@ -22,6 +22,6 @@
  * into the JDO/DataNucleus ObjectStore to provide a number of counters relating to numbers of object loaded,
  * dirtied etc.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_MetricsService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.metrics;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java
index 37bc385..e731579 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/publish/package-info.java
@@ -23,6 +23,6 @@
  * published are action invocations/property edits, and changed objects. A typical use case is to publish onto a
  * pub/sub bus such as ActiveMQ with Camel to keep other systems up to date.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_PublisherService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.publish;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java
index 290f779..3e6485f 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/queryresultscache/package-info.java
@@ -22,6 +22,6 @@
  * response times to the user, by providing a request-scoped cache of the value of some (safe or idempotent) method
  * call. This will typically be as the result of running a query, but could be any expensive operation.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_QueryResultsCache">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.queryresultscache;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java
index 9d6da01..9c15400 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/registry/package-info.java
@@ -22,6 +22,6 @@
  * or looking up domain services (either provided by the framework or application-specific) currently known to the
  * runtime.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_ServiceRegistry">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.registry;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java
index aa4cb8a..67603ba 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/repository/package-info.java
@@ -22,6 +22,6 @@
  * persisting and searching for entities from the underlying persistence store. It acts as an abstraction over the
  * JDO/DataNucleus objectstore.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-api_RepositoryService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.repository;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java
index ca4abd2..dc9c7f0 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/routing/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.routing.RoutingService} provides the ability to return (and therefore
  * render) an alternative object from an action invocation.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_RoutingService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.routing;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java
index b121297..66501bf 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/scratchpad/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.scratchpad.Scratchpad} (request-scoped) domain service allows objects to
  * exchange information even if they do not directly call each other.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_Scratchpad">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.scratchpad;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java
index c9edede..7527d77 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/sessmgmt/package-info.java
@@ -23,6 +23,6 @@
  * from the UI and which create or modify large amounts of data. A classic example is migrating data from one system
  * to another.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_SessionManagementService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.sessmgmt;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java
index 2b8fae9..8d64ee6 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/sudo/package-info.java
@@ -24,6 +24,6 @@
  * another) and while running fixture scripts (eg setting up objects that would normally require several users to have
  * acted upon the objects).
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_testing_SudoService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.sudo;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java
index 4a2a3fd..4a80b28 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/swagger/package-info.java
@@ -21,6 +21,6 @@
  * The {@link SwaggerService} generates Swagger schema definition files to describe the public and/or private
  * RESTful APIs exposed by the RestfulObjects viewer.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_metadata-api_SwaggerService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.swagger;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java
index 112ae2d..dd5921a 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/title/package-info.java
@@ -20,6 +20,6 @@
 /**
  * The {@link org.apache.isis.applib.services.title.TitleService} provides methods to programmatically obtain the title and icon of a domain object.
 
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_TitleService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.title;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java
index d6a695c..fa9add3 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/urlencoding/package-info.java
@@ -24,6 +24,6 @@
  * invoke an action on it), this URL is converted back into a view model memento, from which the view model can then
  * be hydrated
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_UrlEncodingService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.urlencoding;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java
index b9e2a8a..36c8fc4 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/user/package-info.java
@@ -20,6 +20,6 @@
 /**
  * The {@link UserService} allows the domain object to obtain the identity of the user interacting with said object.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_core-domain-api_UserService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.user;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java
index ed5b3c0..ac15bb5 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/userprof/package-info.java
@@ -23,6 +23,6 @@
  * 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.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_presentation-layer-spi_UserProfileService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.userprof;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java
index e508ab6..4499bb7 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/userreg/package-info.java
@@ -22,6 +22,6 @@
  * sign-up to access an application by providing a valid email address, and also provides the capability for users to
  * reset their password if forgotten.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_persistence-layer-spi_UserRegistrationService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.userreg;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/events/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/events/package-info.java
index 903da7a..f3f45ab 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/events/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/events/package-info.java
@@ -21,6 +21,6 @@
  * Interaction events, corresponding to gestures in the user interface; emitted only by the
  * {@link org.apache.isis.applib.services.wrapper.WrapperFactory}.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_WrapperFactory">Reference Guide</a>
+ *
  */
 package org.apache.isis.applib.services.wrapper.events;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java
index 86186a0..14f02ea 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/wrapper/package-info.java
@@ -23,6 +23,6 @@
  * and callee — eg if they reside in different modules — then the wrapper factory is a useful mechanism to ensure that
  * any business constraints defined by the callee are honoured.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_WrapperFactory">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.wrapper;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java
index d961f24..266659f 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/xactn/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.xactn.TransactionService} provides a small number of methods to allow
  * domain objects to influence user transactions.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_application-layer-api_TransactionService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.xactn;
\ No newline at end of file
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java b/api/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java
index e5e2cab..8a5ef39 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/xmlsnapshot/package-info.java
@@ -21,6 +21,6 @@
  * The {@link org.apache.isis.applib.services.xmlsnapshot.XmlSnapshotService} provides the capability to generate
  * XML snapshots (and if required corresponding XSD schemas) based on graphs of domain objects.
  *
- * @see <a href="http://isis.apache.org/guides/rgsvc/rgsvc.html#_rgsvc_integration-api_XmlSnapshotService">Reference guide</a>
+ *
  */
 package org.apache.isis.applib.services.xmlsnapshot;
\ No newline at end of file