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 2015/05/15 20:24:36 UTC

[2/6] isis git commit: ISIS-1133: adocs ... break out services into API vs SPI; using tocify; a bit more on testing.

ISIS-1133: adocs ... break out services into API vs SPI; using tocify; a bit more on testing.

thanks Deltaspike for finding tocify... works nicely!


Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/4d0478a8
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/4d0478a8
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/4d0478a8

Branch: refs/heads/master
Commit: 4d0478a85e55b18d8d02c59edf2d80443f4357a2
Parents: 65d34db
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Fri May 15 18:23:47 2015 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Fri May 15 18:23:47 2015 +0100

----------------------------------------------------------------------
 .../user-guide/_user-guide_reference.adoc       |  12 +-
 ...uide_reference_convenience-superclasses.adoc |   8 -
 .../_user-guide_reference_methods_aaa.adoc      |  27 +-
 .../_user-guide_reference_services-api.adoc     |  30 ++
 .../_user-guide_reference_services-api_aaa.adoc | 215 ++++++++++
 ..._services-api_action-invocation-context.adoc |   8 +
 ...ference_services-api_background-service.adoc |   8 +
 ...reference_services-api_bookmark-service.adoc |   8 +
 ...de_reference_services-api_clock-service.adoc |   8 +
 ..._reference_services-api_command-context.adoc |   8 +
 ...eference_services-api_deep-link-service.adoc |   8 +
 ...ce_services-api_domain-object-container.adoc |   8 +
 ...de_reference_services-api_email-service.adoc |   8 +
 ...eference_services-api_event-bus-service.adoc |  15 +
 ...erence_services-api_guice-bean-provider.adoc |   8 +
 ...reference_services-api_isis-jdo-support.adoc | 129 ++++++
 ..._reference_services-api_memento-service.adoc |   8 +
 ...eference_services-api_metamodel-service.adoc |   8 +
 ...erence_services-api_query-results-cache.adoc |   8 +
 ...uide_reference_services-api_scratch-pad.adoc |   8 +
 ...ide_reference_services-api_sudo-service.adoc |   8 +
 ..._reference_services-api_wrapper-factory.adoc |   8 +
 ...rence_services-api_xml-snapshot-service.adoc |   8 +
 .../_user-guide_reference_services-spi.adoc     |  25 ++
 .../_user-guide_reference_services-spi_aaa.adoc | 214 ++++++++++
 ...reference_services-spi_auditing-service.adoc |  13 +
 ...services-spi_background-command-service.adoc |  12 +
 ...ce_services-spi_class-discovery-service.adoc |   8 +
 ..._reference_services-spi_command-service.adoc |  11 +
 ...ce_services-spi_content-mapping-service.adoc |   8 +
 ...ervices-spi_content-negotiation-service.adoc |   8 +
 ...services-spi_email-notification-service.adoc |   8 +
 ...reference_services-spi_event-serializer.adoc |   8 +
 ...rence_services-spi_exception-recognizer.adoc |   8 +
 ..._reference_services-spi_locale-provider.adoc |   8 +
 ...ference_services-spi_publishing-service.adoc |  11 +
 ...erence_services-spi_translation-service.adoc |   8 +
 ...ence_services-spi_translations-resolver.adoc |   8 +
 ...rence_services-spi_user-profile-service.adoc |   8 +
 ..._services-spi_user-registration-service.adoc |   8 +
 .../_user-guide_reference_services.adoc         |  45 ---
 .../_user-guide_reference_services_aaa.adoc     | 403 -------------------
 ...ence_services_action-invocation-context.adoc |   8 -
 ...ide_reference_services_auditing-service.adoc |  13 -
 ...nce_services_background-command-service.adoc |  12 -
 ...e_reference_services_background-service.adoc |   8 -
 ...ide_reference_services_bookmark-service.adoc |   8 -
 ...erence_services_class-discovery-service.adoc |   8 -
 ...-guide_reference_services_clock-service.adoc |   8 -
 ...uide_reference_services_command-context.adoc |   8 -
 ...uide_reference_services_command-service.adoc |  11 -
 ...erence_services_content-mapping-service.adoc |   8 -
 ...ce_services_content-negotiation-service.adoc |   8 -
 ...de_reference_services_deep-link-service.adoc |   8 -
 ...erence_services_domain-object-container.adoc |   8 -
 ...nce_services_email-notification-service.adoc |   8 -
 ...-guide_reference_services_email-service.adoc |   8 -
 ...de_reference_services_event-bus-service.adoc |  15 -
 ...ide_reference_services_event-serializer.adoc |   8 -
 ...reference_services_exception-recognizer.adoc |   8 -
 ...uide_reference_services_fixture-scripts.adoc |   8 -
 ..._reference_services_guice-bean-provider.adoc |   8 -
 ...ide_reference_services_isis-jdo-support.adoc | 129 ------
 ...uide_reference_services_locale-provider.adoc |   8 -
 ...uide_reference_services_memento-service.adoc |   8 -
 ...de_reference_services_metamodel-service.adoc |   8 -
 ...e_reference_services_publishing-service.adoc |  11 -
 ..._reference_services_query-results-cache.adoc |   8 -
 ...er-guide_reference_services_scratch-pad.adoc |   8 -
 ...r-guide_reference_services_sudo-service.adoc |   8 -
 ..._reference_services_translation-service.adoc |   8 -
 ...eference_services_translations-resolver.adoc |   8 -
 ...reference_services_user-profile-service.adoc |   8 -
 ...ence_services_user-registration-service.adoc |   8 -
 ...uide_reference_services_wrapper-factory.adoc |   8 -
 ...reference_services_xml-snapshot-service.adoc |   8 -
 .../_user-guide_reference_superclasses.adoc     |  52 +++
 ..._reference_superclasses_fixture-scripts.adoc |   8 +
 ...ting_integ-test-support_wrapper-factory.adoc | 106 ++++-
 adocs/template/document.html.erb                |  62 ++-
 80 files changed, 1118 insertions(+), 911 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
index c4a4adc..62324ed 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference.adoc
@@ -5,13 +5,21 @@
 
 IMPORTANT: TODO
 
+Apache Isis includes an extensive number of domain services for your domain objects to use; simply define the service as an annotated field and Isis will inject the service into your object.  These services' API are all defined in Isis' applib (`o.a.i.core:isis-core-applib` module); this minimizes the coupling between your code and Isis.  It also allows you to easily mock out these services in your unit tests.
+
+Some of the services defined in the applib are intended to be used (primarily) not by your domain objects but instead by Isis itself.  A good example of this is the <<__code_auditingservice3_code, `AuditingService3`>> service; if an implementation is present then Isis will call that service in order to record audit log entries.  If no implementation is available then Isis will carry on regardless.
+
+Some domain services can be considered both API and SPI; a good example is the `EmailService` that is of direct use for domain objects wishing to send out emails, but is also used by the framework to support the user registration functionality supported by the <<_wicket_viewer, Wicket viewer>>.   The same is true of the <<__code_eventbusservice_code, `EventBusService`>>; this can be used by domain objects to broadcast arbitrary events, but is also used by the framework to automatically emit events eg for `@Action(domainEvent=...)`.  For these hybrid services we we have categorized the service as an "API" service.
+
+
 include::_user-guide_reference_annotations.adoc[leveloffset=+1]
 include::_user-guide_reference_prefixes.adoc[leveloffset=+1]
 include::_user-guide_reference_methods.adoc[leveloffset=+1]
-include::_user-guide_reference_services.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi.adoc[leveloffset=+1]
+include::_user-guide_reference_superclasses.adoc[leveloffset=+1]
 include::_user-guide_reference_value-types.adoc[leveloffset=+1]
 include::_user-guide_reference_applib-utility-classes.adoc[leveloffset=+1]
-include::_user-guide_reference_convenience-superclasses.adoc[leveloffset=+1]
 include::_user-guide_reference_mixins.adoc[leveloffset=+1]
 include::_user-guide_reference_addons.adoc[leveloffset=+1]
 

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc
deleted file mode 100644
index 5a8e956..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_convenience-superclasses.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-= Convenience Superclasses
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-IMPORTANT: TODO
-
-

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
index ff6d049..7c83936 100644
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_methods_aaa.adoc
@@ -15,30 +15,23 @@ The table below lists the reserved methods that are recognized as part of Apache
 |Method
 |Description
 
-|<<__code_cssClass_code, `cssClass()`>>
+|<<__code_cssclass_code, `cssClass()`>>
 |Provides a CSS class for this object, which is added as a style in the containing when rendering the object within a table, or to a containing when rendering the object on a page. In conjunction with css/application.css, can therefore provide custom styling of an object instance wherever it is rendered.
 See also <<__code_title_code, `title()`>> and <<__code_iconName_code, `iconName()`>>.
 
-|<<__code_iconName_code, `iconName()`>>
+|<<__code_iconname_code, `iconName()`>>
 |Provides the name of the image to render, usually alongside the title, to represent the object. If not provided, then the class name is used to locate an image.
 See also <<__code_title_code, `title()`>> and <<__code_cssClass_code, `cssClass()`>>
 
-|<<__code_getId_code, `getId()`>>
-|Y
+|<<__code_getid_code, `getId()`>>
 |Provides an optional unique identifier of a service. +
 If not provided, the services fully-qualified class name is used.
 
 |<<__code_title_code, `title()`>>
-|Y
 |Provides a title for the object. +
-Alternatively, use the <<__code_title_code, <<__code_@Title`>> annotation. It is also possible to use `toString_code, `@Title`>> annotation. It is also possible to use `toString()`>>. +
+Alternatively, use the <<__code_title_code, `@Title`>> annotation. +
 See also `iconName()` and <<__code_cssClass_code, `cssClass()`>>
 
-|<<__code_toString_code, `toString()`>>
-|Y
-|Used as the fallback title for an object if there is no <<__code_title_code, `title()`>> method or properties annotated with the <<__code_title_code, `@Title`>> annotation.
-
-
 |===
 
 
@@ -100,25 +93,23 @@ Some lifecycle methods have been deprecated:
 |Method
 |Notes
 
-|<<__code_deleted_code, `deleted()`>>
+|`deleted()`
 |Replaced by <<__code_removed_code, `removed()`>>
 
-|<<__code_deleting_code, `deleting()`>>
+|`deleting()`
 |Replaced by removing()`
 
-|`loading`
+|`loading()`
 |callback for when the (persistent) object is just about to be loaded from the object store. +
 [WARNING]
 ====
 This method is never called.
 ====
 
-|<<__code_saved_code, `saved()`>>
-|Y
+|`saved()`
 |Replaced by persisted()`
 
-|<<__code_saving_code, `saving()`>>
-|Y
+|`saving()`
 |Replaced by <<__code_persisting_code, `persisting()`>>
 
 |===

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc
new file mode 100644
index 0000000..f613063
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api.adoc
@@ -0,0 +1,30 @@
+= Domain Services (API)
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+IMPORTANT: TODO
+
+include::_user-guide_reference_services-api_aaa.adoc[leveloffset=+1]
+
+include::_user-guide_reference_services-api_action-invocation-context.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_background-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_bookmark-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_clock-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_command-context.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_deep-link-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_domain-object-container.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_email-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_event-bus-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_guice-bean-provider.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_isis-jdo-support.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_memento-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_metamodel-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_query-results-cache.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_scratch-pad.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_sudo-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_wrapper-factory.adoc[leveloffset=+1]
+include::_user-guide_reference_services-api_xml-snapshot-service.adoc[leveloffset=+1]
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc
new file mode 100644
index 0000000..4bb02a9
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_aaa.adoc
@@ -0,0 +1,215 @@
+= Summary
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+
+IMPORTANT: TODO
+
+
+== Applib Services
+
+The table below summarizes all the APIs defined by Apache Isis.  It also lists their corresponding implementation, either a default implementation provided by Isis itself, or provided by one of the in http://isisaddons.org[Isis Addons] (non-ASF)modules.
+
+.Domain Services
+[cols="2,4a,1,1", options="header"]
+|===
+
+|API
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+|<<__code_actioninvocationcontext_code, `o.a.i.applib.` +
+`services.actinv` +
+`ActionInvocation-` +
+`Context`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ActionInvocationContext`
+|API is also concrete class
+
+|<<__code_backgroundservice_code, `o.a.i.applib.` +
+`services.background` +
+`BackgroundService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`BackgroundServiceDefault`
+|depends on: +
+`BackgroundCommandService`
+
+|<<__code_bookmarkservice_code, `o.a.i.applib.` +
+`services.bookmark` +
+`BookmarkService`>>
+|``o.a.i.core`` +
+``isis-core-metamodel``
+|`BookmarkServiceDefault`
+|related services:
+`BookmarkHolder-` ++
+`ActionContributions`,
+`BookmarkHolder-` ++
+`AssociationContributions`
+
+|<<__code_clockservice_code, `o.a.i.applib.` +
+`services.clock` +
+`ClockService`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ClockService`
+|API is also a concrete class.
+
+|<<__code_commandcontext_code, `o.a.i.applib.` +
+`services.command` +
+`CommandContext`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`CommandContext`
+|API is also a concrete class. +
+depends on: +
+`CommandService` for persistent `Command`, else in-memory impl. used
+
+|<<__code_deeplinkservice_code, `o.a.i.applib` +
+`services.deeplink` +
+`DeepLinkService`>>
+|``o.a.i.viewer`` +
+``isis-viewer-wicket-impl``
+|`DeepLinkServiceWicket`
+|Implementation only usable within Wicket viewer
+
+|<<__code_domainobjectcontainer_code, `o.a.i.applib` +
+`DomainObjectContainer`>>
+|``o.a.i.core`` +
+``isis-core-metamodel``
+|`DomainObjectContainerDefault`
+|
+
+|<<__code_emailservice_code, `o.a.i.applib.` +
+`services.email` +
+`EmailService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`EmailServiceDefault`
+|
+
+|<<__code_eventbusservice_code, `o.a.i.applib.` +
+`services.eventbus` +
+`EventBusService`>>
+|``o.a.i.core`` +
+``isis-core-objectstore-jdo-datanucleus``
+|`EventBusServiceJdo`
+|
+
+|<<__code_guicebeanprovider_code, `o.a.i.applib.` +
+`services.guice` +
+`GuiceBeanProvider`>>
+|``o.a.i.core`` +
+``isis-viewer-wicket-impl``
+|`GuiceBeanProviderWicket`
+|
+
+|<<__code_isisjdosupport_code, `o.a.i.applib.` +
+`services.jdosupport` +
+`IsisJdoSupport`>>
+|``o.a.i.core`` +
+``isis-core-objectstore-jdo-datanucleus``
+|`IsisJdoSupportImpl`
+|
+
+|<<__code_mementoservice_code, `o.a.i.applib.` +
+`services.memento` +
+`MementoService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`MementoServiceDefault`
+|
+
+|<<__code_metamodelservice_code, `o.a.i.applib.` +
+`services.metamodel` +
+`MetaModelService`>>
+|``o.a.i.core`` +
+``isis-core-metamodel``
+|`MetaModelServiceDefault`
+|
+
+|<<__code_queryresultscache_code, `o.a.i.applib.` +
+`services.` +
+`queryresultscache` +
+`QueryResultsCache`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`QueryResultsCache`
+|API is also a concrete class
+
+|<<__code_scratchpad_code, `o.a.i.applib.` +
+`services.scratchpad` +
+`Scratchpad`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`Scratchpad`
+|API is also a concrete class
+
+|<<__code_scratchpad_code, `o.a.i.applib.` +
+`services.sudo` +
+`SudoService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`SudoServiceDefault`
+|API is also a concrete class
+
+|<<__code_wrapperfactory_code, `o.a.i.applib.` +
+`services.wrapper` +
+`WrapperFactory`>>
+|``o.a.i.core`` +
+``isis-core-wrapper``
+|`WrapperFactoryDefault`
+|
+
+|<<__code_xmlsnapshotservice_code, `o.a.i.applib.` +
+`services.xmlsnapshot` +
+`XmlSnapshotService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`XmlSnapshotServiceDefault`
+|
+
+|===
+
+Key:
+
+* `o.a.i` is an abbreviation for `org.apache.isis`
+* `o.ia.m` is an abbreviation for `org.isisaddons.module`
+
+
+
+
+== Deprecated Services
+
+There is also a number of deprecated domain services.
+
+.Deprecated Domain Services
+[cols="2,4a,1,1", options="header"]
+|===
+
+|API
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+|`o.a.i.applib.` +
+`annotation`
+`Bulk.InteractionContext`
+|``o.a.i.core`` +
+``isis-core-applib``
+|`Bulk.InteractionContext`
+|Replaced by `ActionInvocationContext`
+
+
+|===
+
+Key:
+
+* `o.a.i` is an abbreviation for `org.apache.isis`
+* `o.ia.m` is an abbreviation for `org.isisaddons.module`

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc
new file mode 100644
index 0000000..989d131
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_action-invocation-context.adoc
@@ -0,0 +1,8 @@
+= `ActionInvocationContext`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc
new file mode 100644
index 0000000..74c69e5
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_background-service.adoc
@@ -0,0 +1,8 @@
+= `BackgroundService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc
new file mode 100644
index 0000000..5d0024a
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_bookmark-service.adoc
@@ -0,0 +1,8 @@
+= `BookmarkService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc
new file mode 100644
index 0000000..1b4675d
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_clock-service.adoc
@@ -0,0 +1,8 @@
+= `ClockService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc
new file mode 100644
index 0000000..15c250c
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_command-context.adoc
@@ -0,0 +1,8 @@
+= `CommandContext`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc
new file mode 100644
index 0000000..7135b31
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_deep-link-service.adoc
@@ -0,0 +1,8 @@
+= `DeepLinkService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc
new file mode 100644
index 0000000..53d253f
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_domain-object-container.adoc
@@ -0,0 +1,8 @@
+= `DomainObjectContainer`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc
new file mode 100644
index 0000000..6f78302
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_email-service.adoc
@@ -0,0 +1,8 @@
+= `EmailService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc
new file mode 100644
index 0000000..43275fe
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_event-bus-service.adoc
@@ -0,0 +1,15 @@
+= `EventBusService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+## Implementation
+
+IMPORTANT: TODO
+
+## Registration
+
+The `EventBusServiceJdo` class provides the default implementation and (as of 1.6.0+) is automatically registered using `@DomainService`.  No further configuration is necessary.
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc
new file mode 100644
index 0000000..99f4f36
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_guice-bean-provider.adoc
@@ -0,0 +1,8 @@
+= `GuiceBeanProvider`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc
new file mode 100644
index 0000000..3c1873a
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_isis-jdo-support.adoc
@@ -0,0 +1,129 @@
+= `IsisJdoSupport`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+The `IsisJdoSupport` service provides a number of general purpose methods for working with the JDO/DataNucleus objectstore.
+
+
+== API
+
+The API provided by `IsisJdoSupport` is:
+
+[source,java]
+----
+public interface IsisJdoSupport {
+    List<Map<String, Object>> executeSql(String sql);
+    Integer executeUpdate(String sql);
+    void deleteAll(Class<?>... pcClasses);
+    <T> T refresh(T domainObject);
+    void ensureLoaded(Collection<?> collectionOfDomainObjects);
+    PersistenceManager getJdoPersistenceManager();
+}
+----
+
+Each of these methods are discussed in more details below.
+
+
+== Executing arbitrary SQL
+
+The `executeSql(...)` method allows arbitrary queries to be submitted:
+
+[source,java]
+----
+List<Map<String, Object>> results = isisJdoSupport.executeSql("select * from custMgmt.customers");
+----
+
+The result set is automatically converted into a list of maps, where the map key is the column name.
+
+
+In a similar manner, the `executeUpdate(...)` allows arbitrary updates to be performed.
+
+[source,java]
+----
+int count = isisJdoSupport.executeUpdate("select count(*) from custMgmt.customers);
+----
+
+The returned value is the number of rows updated.
+
+
+
+== Fixture support
+
+The `deleteAll(...)` method is provided pretty much exclusively for tearing down fixture data:
+
+[source,java]
+----
+deleteAll(Order.class);
+deleteAll(CustomerAddress.class);
+deleteAll(Customer.class);
+----
+
+[NOTE]
+====
+It can occasionally be the case that Isis' internal adapter for the domain object is
+still in memory.  JDO/DataNucleus seems to bump up the version of the object prior to its deletion,
+which under normal circumstances would cause Isis to throw a concurrency exception.  Therefore
+to prevent this from happening (ie to <i>force</i> the deletion of all instances), concurrency checking
+is temporarily disabled while this method is performed.
+====
+
+
+
+== Reloading entities
+
+A http://www.datanucleus.org/products/datanucleus/jdo/orm/relationships.html[known limitation] of DataNucleus' implementation of JDO is that persisting a child entity (in a 1:n bidirectional relationship) does not cause the parent's collection to be updated.
+
+The `refresh(T domainObject)` method can be used to reload the parent object (or indeed any object).
+
+For example:
+
+[source,java]
+----
+public Order newOrder(final Customer customer) {
+    Order order = newTransientInstance(Order.class);
+    order.setCustomer(customer);
+    persist(customer);
+    getContainer().flush(); // <1>
+    isisJdoSupport.refresh(customer); // <2>
+    return order;
+}
+----
+<1> flush to database
+<2> reload parent from database
+
+
+[NOTE]
+====
+The particular example that led to this method being added was a 1:m bidirectional relationship,
+analogous to `Customer <-> * Order`.  Persisting the child `Order` object did not cause
+the parent ``Customer``'s collection of orders to be updated.  In fact, JDO does not make any
+such guarantee to do so.  Options are therefore either to maintain the collection in code, or to
+refresh the parent.
+
+====
+
+
+
+
+== Using JDO `PersistenceManager` directly
+
+Apache Isis provides a simplified API on top of only supports JDO, and so does not support all of JDO's features.  For example, Isis (currently) only supports named queries.  If you require more flexibility than this, eg for dynamically constructed queries, then the service provides access to the underlying JDO `PersistenceManager` API:
+
+[source,java]
+----
+public List<Order> findOrders(...) {
+    javax.jdo.PersistenceManager pm = isisJdoSupport.getPersistenceManager();
+
+    // knock yourself out...
+
+    return someListOfOrders;
+}
+----
+
+
+
+== Registering the Service
+
+The `IsisJdoSupportImpl` class provides the default implementation and (as of 1.6.0+) is automatically registered using `@DomainService`.  No further configuration is necessary.

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc
new file mode 100644
index 0000000..f06a824
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_memento-service.adoc
@@ -0,0 +1,8 @@
+= `MementoService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc
new file mode 100644
index 0000000..cb298dc
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_metamodel-service.adoc
@@ -0,0 +1,8 @@
+= `MetamodelService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc
new file mode 100644
index 0000000..0b22d23
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_query-results-cache.adoc
@@ -0,0 +1,8 @@
+= `QueryResultsCache`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc
new file mode 100644
index 0000000..0a11596
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_scratch-pad.adoc
@@ -0,0 +1,8 @@
+= `ScratchPad`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc
new file mode 100644
index 0000000..bb33642
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_sudo-service.adoc
@@ -0,0 +1,8 @@
+= `SudoService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
new file mode 100644
index 0000000..75e9d25
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_wrapper-factory.adoc
@@ -0,0 +1,8 @@
+= `WrapperFactory`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc
new file mode 100644
index 0000000..f82a24a
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-api_xml-snapshot-service.adoc
@@ -0,0 +1,8 @@
+= `XmlSnapshotService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc
new file mode 100644
index 0000000..ddf79f6
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi.adoc
@@ -0,0 +1,25 @@
+= Domain Services (SPI)
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+IMPORTANT: TODO
+
+include::_user-guide_reference_services-spi_aaa.adoc[leveloffset=+1]
+
+include::_user-guide_reference_services-spi_auditing-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_background-command-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_class-discovery-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_command-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_content-mapping-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_content-negotiation-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_email-notification-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_event-serializer.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_exception-recognizer.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_locale-provider.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_publishing-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_translation-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_translations-resolver.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_user-profile-service.adoc[leveloffset=+1]
+include::_user-guide_reference_services-spi_user-registration-service.adoc[leveloffset=+1]

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc
new file mode 100644
index 0000000..fa3baef
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_aaa.adoc
@@ -0,0 +1,214 @@
+= Summary
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+
+
+IMPORTANT: TODO
+
+== Applib SPIs
+
+IMPORTANT: TODO
+
+.Domain Services
+[cols="2,4a,1,1", options="header"]
+|===
+
+|API
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+|<<__code_auditingservice3_code, `o.a.i.applib.` +
+`services.audit` +
+`AuditingService3`>>
+|``o.ia.m.audit`` +
+``isis-module-audit``
+|`AuditingService`
+|related services:
+`AuditingService-` +
+`Contributions`,
+`AuditingService-` +
+`Repository`
+
+|<<__code_backgroundcommandservice_code, `o.a.i.applib.` +
+`services.background` +
+`BackgroundCommandService`>>
+|``o.ia.m.command`` +
+``isis-module-command``
+|`BackgroundCommandServiceJdo`
+|related services:
+`BackgroundCommandService-` +
+`JdoContributions`,
+`BackgroundCommandService-` +
+`JdoRepository`
+
+|<<__code_classdiscoveryservice_code, `o.a.i.applib.` +
+`services.classdiscovery` +
+`ClassDiscoveryService`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ClassDiscoveryService-` +
+`UsingReflections`
+|requires `org.reflections:reflections` as Maven dependency
+
+|<<__code_commandservice_code, `o.a.i.applib.` +
+`services.command.spi` +
+`CommandService`>>
+|``o.ia.m.command`` +
+``isis-module-command``
+|`CommandServiceJdo`
+|related services: +
+`CommandService-` ++
+`JdoContributions`,
+`CommandService-` ++
+`JdoRepository`
+
+|<<__code_emailnotificationservice_code, `o.a.i.applib.` +
+`services.userreg` +
+`EmailNotificationService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`EmailNotificationService-` ++
+`Default`
+|depends on: +
+a configured `EmailService`
+
+|<<__code_eventserializer_code, `o.a.i.applib.` +
+`services.publish` +
+`EventSerializer`>>
+|``o.ia.m.publishing`` +
+``isis-module-publishing``
+|`RestfulObjects-` +
+`SpecEventSerializer`
+|
+
+|<<__code_exceptionrecognizer_code, `o.a.i.applib.` +
+`services.exceprecog` +
+`ExceptionRecognizer`>>
+|``o.a.i.core`` +
+``isis-core-applib``
+|`ExceptionRecognizer-` +
+`CompositeFor-` +
+`JdoObjectStore`
+|Extensible using composite pattern if required
+
+|<<__code_localeprovider_code, `o.a.i.applib.` +
+`services.i18n` +
+`LocaleProvider`>>
+|``o.a.i.viewer`` +
+``isis-viewer-wicket-impl``
+|`LocaleProviderWicket`
+|
+
+|<<__code_publishingservice_code, `o.a.i.applib.` +
+`services.publish` +
+`PublishingService`>>
+|``o.ia.m.publishing`` +
+``isis-module-publishing``
+|`PublishingService`
+|related services:
+`PublishingService-` ++
+`Contributions`,
+`PublishingService-` ++
+`Repository`.  +
+depends on: +
+`EventSerializer`
+
+|<<__code_translationservice_code, `o.a.i.applib.` +
+`services.i18n` +
+`TranslationService`>>
+|``o.a.i.core`` +
+``isis-core-runtime``
+|`TranslationServicePo`
+|related services: `TranslationServicePoMenu` +
+depends on: +
+`TranslationsResolver`, `LocaleProvider`
+
+|<<__code_translationsresolver_code, `o.a.i.applib.` +
+`services.i18n` +
+`TranslationsResolver`>>
+|``o.a.i.viewer`` +
+``isis-viewer-wicket-impl``
+|`TranslationsResolverWicket`
+|
+
+|<<__code_userprofileservice_code, `o.a.i.applib.` +
+`services.userprof` +
+`UserProfileService`>>
+|
+|
+|SPI only
+
+|<<__code_userregistrationservice_code, `o.a.i.applib.` +
+`services.userreg` +
+`UserRegistrationService`>>
+|``o.ia.m.security`` +
+``isis-module-security``
+|`SecurityModule-` +
+`AppUserRegistrationService`
+|depends (implicitly) on: +
+a configured `EmailService`
+
+
+|===
+
+
+Key:
+
+* `o.a.i` is an abbreviation for `org.apache.isis`
+* `o.ia.m` is an abbreviation for `org.isisaddons.module`
+
+
+All domain services are automatically registered (annotated with <<__code_domainservice_code, `@DomainService`>>) except:
+
+
+
+* `ExceptionRecognizer` +
++
+Register explicitly in isis.properties (so is extensible)
+
+
+
+
+
+== "Internal" SPIs
+
+These services definitions depend on the internals of the framework; we do not guarantee that link:semver.org[semantic versioning] will be honoured for these APIs.
+
+
+.Semi-public SPI
+[cols="3,3,2,2a", options="header"]
+|===
+
+|SPI
+|Maven Module +
+Impl'n (g: a:)
+|Implementation
+|Notes
+
+
+|<<__code_contentmappingservice_code, `o.a.i.v.ro.` +
+`rendering.service.conneg.` +
+`ContentMappingService`>>
+|
+|
+|No default implementation.
+
+|<<__code_contentnegotiationservice_code, `o.a.i.v.ro.` +
+`rendering.service.conneg.` +
+`ContentNegotiationService`>>
+|``o.a.i.core`` +
+`isis-core-viewer-restfulobjects-rendering`
+|`ContentNegotiationService-` +
+`XRoDomainType`
+|
+
+
+|===
+
+Key:
+
+* `o.a.i.v.ro` is an abbreviation for `org.apache.isis.viewer.restfulobjects`

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc
new file mode 100644
index 0000000..e4626d2
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_auditing-service.adoc
@@ -0,0 +1,13 @@
+= `AuditingService3`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-audit[Isis addons' Audit module] (non-ASF).

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc
new file mode 100644
index 0000000..3111628
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_background-command-service.adoc
@@ -0,0 +1,12 @@
+= `BackgroundCommandService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-command[Isis addons' Command module] (non-ASF).
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc
new file mode 100644
index 0000000..075cf62
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_class-discovery-service.adoc
@@ -0,0 +1,8 @@
+= `ClassDiscoveryService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc
new file mode 100644
index 0000000..ab86189
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_command-service.adoc
@@ -0,0 +1,11 @@
+= `CommandService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-command[Isis addons' Command module] (non-ASF).

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc
new file mode 100644
index 0000000..09d20f9
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-mapping-service.adoc
@@ -0,0 +1,8 @@
+= `ContentMappingService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc
new file mode 100644
index 0000000..89933f9
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_content-negotiation-service.adoc
@@ -0,0 +1,8 @@
+= `ContentNegotiationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc
new file mode 100644
index 0000000..2a99016
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_email-notification-service.adoc
@@ -0,0 +1,8 @@
+= `EmailNotificationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc
new file mode 100644
index 0000000..2c20560
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_event-serializer.adoc
@@ -0,0 +1,8 @@
+= `EventSerializer`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc
new file mode 100644
index 0000000..04e7561
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_exception-recognizer.adoc
@@ -0,0 +1,8 @@
+= `ExceptionRecognizer`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc
new file mode 100644
index 0000000..4956f49
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_locale-provider.adoc
@@ -0,0 +1,8 @@
+= `LocaleProvider`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc
new file mode 100644
index 0000000..93b17c1
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_publishing-service.adoc
@@ -0,0 +1,11 @@
+= `PublishingService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+
+== Isis Addons Implementation
+
+For 1.7.0+, see the http://github.com/isisaddons/isis-module-publishing[Isis addons' Publishing module] (non-ASF).

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc
new file mode 100644
index 0000000..0c1b16e
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translation-service.adoc
@@ -0,0 +1,8 @@
+= `TranslationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc
new file mode 100644
index 0000000..7148bc7
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_translations-resolver.adoc
@@ -0,0 +1,8 @@
+= `TranslationsResolver`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc
new file mode 100644
index 0000000..6b56835
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-profile-service.adoc
@@ -0,0 +1,8 @@
+= `UserProfileService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc
new file mode 100644
index 0000000..ab1a666
--- /dev/null
+++ b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services-spi_user-registration-service.adoc
@@ -0,0 +1,8 @@
+= `UserRegistrationService`
+:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+:_basedir: ../
+:_imagesdir: images/
+
+IMPORTANT: TODO
+
+

http://git-wip-us.apache.org/repos/asf/isis/blob/4d0478a8/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc b/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
deleted file mode 100644
index e4eff00..0000000
--- a/adocs/documentation/src/main/asciidoc/user-guide/_user-guide_reference_services.adoc
+++ /dev/null
@@ -1,45 +0,0 @@
-= Domain Services
-:Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR  CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-:_basedir: ../
-:_imagesdir: images/
-
-
-IMPORTANT: TODO
-
-include::_user-guide_reference_services_aaa.adoc[leveloffset=+1]
-
-include::_user-guide_reference_services_action-invocation-context.adoc[leveloffset=+1]
-include::_user-guide_reference_services_auditing-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_background-command-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_background-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_bookmark-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_class-discovery-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_clock-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_command-context.adoc[leveloffset=+1]
-include::_user-guide_reference_services_command-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_content-mapping-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_content-negotiation-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_deep-link-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_domain-object-container.adoc[leveloffset=+1]
-include::_user-guide_reference_services_email-notification-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_email-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_event-bus-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_event-serializer.adoc[leveloffset=+1]
-include::_user-guide_reference_services_exception-recognizer.adoc[leveloffset=+1]
-include::_user-guide_reference_services_fixture-scripts.adoc[leveloffset=+1]
-include::_user-guide_reference_services_guice-bean-provider.adoc[leveloffset=+1]
-include::_user-guide_reference_services_isis-jdo-support.adoc[leveloffset=+1]
-include::_user-guide_reference_services_locale-provider.adoc[leveloffset=+1]
-include::_user-guide_reference_services_memento-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_metamodel-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_publishing-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_query-results-cache.adoc[leveloffset=+1]
-include::_user-guide_reference_services_scratch-pad.adoc[leveloffset=+1]
-include::_user-guide_reference_services_sudo-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_translation-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_translations-resolver.adoc[leveloffset=+1]
-include::_user-guide_reference_services_user-profile-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_user-registration-service.adoc[leveloffset=+1]
-include::_user-guide_reference_services_wrapper-factory.adoc[leveloffset=+1]
-include::_user-guide_reference_services_xml-snapshot-service.adoc[leveloffset=+1]
-