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 2021/02/07 14:49:54 UTC
[isis] branch ISIS-2444 updated: ISIS-2526: wip,
reworking the ref guide services to use generated index.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch ISIS-2444
in repository https://gitbox.apache.org/repos/asf/isis.git
The following commit(s) were added to refs/heads/ISIS-2444 by this push:
new 5302b59 ISIS-2526: wip, reworking the ref guide services to use generated index.
5302b59 is described below
commit 5302b59ceba7435f45dd01ee9911975a45dc1161
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Sun Feb 7 14:49:38 2021 +0000
ISIS-2526: wip, reworking the ref guide services to use generated index.
---
.../applib-svc/pages/AcceptHeaderService.adoc | 21 +------
.../{usage_notes.adoc => examples_and_usage.adoc} | 7 ++-
.../{ => hooks}/implementation.adoc | 2 +-
.../hooks/introductory_notes.adoc | 8 ---
.../pages/ApplicationFeatureRepository.adoc | 33 ++--------
.../hooks/_summary.adoc | 11 ++++
.../{see_also.adoc => examples_and_usage.adoc} | 4 +-
.../{ => hooks}/implementation.adoc | 1 +
.../hooks/introductory_notes.adoc | 3 -
.../modules/applib-svc/pages/BookmarkService.adoc | 20 +-----
.../{usage_notes.adoc => examples_and_usage.adoc} | 24 ++++++++
.../{ => hooks}/implementation.adoc | 2 +
.../BookmarkService/hooks/introductory_notes.adoc | 13 ----
.../pages/BookmarkService/hooks/see_also.adoc | 6 --
.../applib-svc/pages/BookmarkUiService.adoc | 13 +---
.../hooks/examples_and_usage.adoc} | 0
.../{ => hooks}/implementation.adoc | 2 +
.../hooks/introductory_notes.adoc | 3 -
.../modules/applib-svc/pages/ClockService.adoc | 17 +----
.../{usage_notes.adoc => examples_and_usage.adoc} | 7 ++-
.../ClockService/{ => hooks}/implementation.adoc | 1 +
.../ClockService/hooks/introductory_notes.adoc | 2 -
.../pages/CommandDtoProcessorService.adoc | 9 +--
.../hooks/examples_and_usage.adoc | 19 ++++++
.../{ => hooks}/implementation.adoc | 3 +
.../CommandDtoProcessorService/hooks/see_also.adoc | 5 --
.../applib-svc/pages/CommandExecutorService.adoc | 45 +-------------
.../CommandExecutorService/hooks/_summary.adoc | 10 +++
.../hooks/examples_and_usage.adoc | 18 ++++++
.../hooks}/implementation.adoc | 4 ++
.../hooks/introductory_notes.adoc | 3 -
.../applib-svc/pages/CommandSubscriber.adoc | 5 +-
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 4 +-
.../hooks/introductory_notes.adoc | 3 -
.../applib-svc/pages/ConfigurationMenu.adoc | 25 +-------
.../hooks/examples_and_usage.adoc} | 3 +-
.../hooks}/implementation.adoc | 3 +
.../hooks/introductory_notes.adoc | 3 -
.../applib-svc/pages/ConfigurationViewService.adoc | 60 +-----------------
.../hooks/examples_and_usage.adoc} | 42 -------------
.../hooks}/implementation.adoc | 4 +-
.../hooks/introductory_notes.adoc | 3 -
.../ConfigurationViewService/implementation.adoc | 5 --
.../applib-svc/pages/ContentMappingService.adoc | 72 +---------------------
.../ContentMappingService/hooks/_summary.adoc | 5 ++
.../hooks/examples_and_usage.adoc | 20 ++++++
.../hooks/implementation.adoc} | 49 +--------------
.../hooks/introductory_notes.adoc | 3 -
.../ContentMappingService/implementation.adoc | 5 --
.../modules/applib-svc/pages/DeepLinkService.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../DeepLinkService/hooks/introductory_notes.adoc | 3 -
.../pages/DeepLinkService/implementation.adoc | 5 --
.../{see_also.adoc => examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/introductory_notes.adoc | 3 -
.../EmailNotificationService/implementation.adoc | 5 --
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../EmailService/hooks/introductory_notes.adoc | 3 -
.../pages/EmailService/implementation.adoc | 5 --
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/introductory_notes.adoc | 3 -
.../ErrorReportingService/implementation.adoc | 5 --
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../EventBusService/hooks/introductory_notes.adoc | 3 -
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../XmlSnapshotService/hooks/implementation.adoc | 1 +
.../hooks/examples_and_usage.adoc} | 0
.../hooks}/implementation.adoc | 0
.../processor/spi/CommandDtoProcessorService.java | 10 +++
.../services/confview/ConfigurationMenu.java | 5 ++
.../confview/ConfigurationViewService.java | 8 +++
161 files changed, 256 insertions(+), 481 deletions(-)
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService.adoc
index cde3dd3..5e3db8f 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService.adoc
@@ -2,26 +2,11 @@
= AcceptHeaderService
: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 simply exposes the HTTP `Accept` header to the domain.
+include::system:generated:page$index/applib/services/acceptheader/AcceptHeaderService.adoc[]
-Its intended use is to support multiple versions of a REST API, where the responsibility for content negotiation (determining which version of the REST API is to be used) is managed by logic in the domain objects themselves.
+include::AcceptHeaderService/hooks/implementation.adoc[]
-include::AcceptHeaderService/hooks/introductory_notes.adoc[]
-
-== API
-
-include::system:generated:page$index/applib/services/acceptheader/AcceptHeaderService.adoc[leveloffset=+2]
-
-
-== Implementation
-
-include::AcceptHeaderService/implementation.adoc[]
-
-
-== Usage Notes
-
-include::AcceptHeaderService/hooks/usage_notes.adoc[]
+include::AcceptHeaderService/hooks/examples_and_usage.adoc[]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/usage_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/examples_and_usage.adoc
similarity index 78%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/usage_notes.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/examples_and_usage.adoc
index 3d8ef4b..289403b 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/usage_notes.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/examples_and_usage.adoc
@@ -3,6 +3,8 @@
:page-partial:
+== Usage Notes
+
The intended use of this service is where there are multiple concurrent versions of a REST API, for backward compatibility of existing clients.
The `AcceptHeaderService` allows the responsibility for content negotiation (determining which version of the REST API is to be used) to be performed by logic in the domain objects themselves.
@@ -19,8 +21,11 @@ Based on this it delegates to the appropriate underlying domain service (with a
The service does not define any conventions as to the format of the media types.
The option is to use the media type's type/subtype, eg `application/vnd.myrestapi-v1+json`; an alternative is to use a media type parameter as a hint, eg `application/json;x-my-rest-api-version=1` (where `x-my-rest-api-version` is the media type parameter).
-The Restful Objects specification does this something similar with its own `x-ro-domain-type` media type parameter; this is used by the xref:refguide:applib-svc:ContentMappingService.adoc[`ContentMappingService`] to determine how to map domain objects to view models/DTOs.
====
+== Alternatives
+
+As an alternative to performing content negotiation within the domain classes, the xref:refguide:applib-svc:ContentMappingService.adoc[`ContentMappingService`] SPI domain service allows the framework to perform the content negotiation responsibility.
+The Restful Objects specification supports this with its own `x-ro-domain-type` media type parameter; this is used by the xref:refguide:applib-svc:ContentMappingService.adoc[`ContentMappingService`] to determine how to map domain objects to view models/DTOs.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/implementation.adoc
similarity index 98%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/implementation.adoc
index e53b262..5f1ea73 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/implementation.adoc
@@ -1,7 +1,7 @@
: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 [...]
-
+== Implementation
The xref:vro:ROOT:about.adoc[Restful Objects] viewer provides an implementation of this API, `o.a.i.viewer.restfulobjects.rendering.service.acceptheader.AcceptHeaderServiceForRest`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/introductory_notes.adoc
deleted file mode 100644
index 0b29f9f..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,8 +0,0 @@
-
-: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:
-
-[TIP]
-====
-As an alternative to performing content negotiation within the domain classes, the xref:refguide:applib-svc:ContentMappingService.adoc[`ContentMappingService`] SPI domain service allows the framework to perform the content negotiation responsibility.
-====
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository.adoc
index 9a37f3c..533e492 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository.adoc
@@ -1,37 +1,12 @@
-[#]ApplicationFeatureRepository]
+[#ApplicationFeatureRepository]
= ApplicationFeatureRepository
: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:
+include::system:generated:page$index/applib/services/appfeat/ApplicationFeatureRepository.adoc[]
-Provides the access to string representations of the packages, classes and class members (collectively: "application features") of the domain classes within the framework's internal metamodel.
+include::ApplicationFeatureRepository/hooks/implementation.adoc[]
-== API
-
-include::system:generated:page$index/applib/services/appfeat/ApplicationMemberType.adoc[leveloffset=+2]
-
-
-// TODO - v2 (reconcile/move into javadoc).
-
-//where `ApplicationMemberType` in turn is:
-//
-//[source,java]
-//----
-//include::refguide:applib-svc:example$services/appfeat/ApplicationMemberType.java[tags=refguide]
-//----
-//
-//These methods are designed primarily to return lists of strings for use in drop-downs.
-
-
-
-== Implementation
-
-include::ApplicationFeatureRepository/implementation.adoc[]
-
-
-== See Also
-
-include::ApplicationFeatureRepository/hooks/see_also.adoc[]
+include::ApplicationFeatureRepository/hooks/examples_and_usage.adoc[]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/_summary.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/_summary.adoc
new file mode 100644
index 0000000..bc5e758
--- /dev/null
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/_summary.adoc
@@ -0,0 +1,11 @@
+// TODO - v2 (reconcile/move into javadoc).
+
+//where `ApplicationMemberType` in turn is:
+//
+//[source,java]
+//----
+//include::refguide:applib-svc:example$services/appfeat/ApplicationMemberType.java[tags=refguide]
+//----
+//
+//These methods are designed primarily to return lists of strings for use in drop-downs.
+
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/examples_and_usage.adoc
similarity index 98%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/examples_and_usage.adoc
index 4f8c3cf..4e2ee6b 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/see_also.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/examples_and_usage.adoc
@@ -1,6 +1,8 @@
: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:
+
+
+== See Also
The default implementation of this service uses the internal xref:core:runtime-services:ApplicationFeatureFactory.adoc[`ApplicationFeatureFactory`] service to instantiate `ApplicationFeature` instances.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/implementation.adoc
similarity index 98%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/implementation.adoc
index d8041c9..c3af492 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/implementation.adoc
@@ -2,6 +2,7 @@
: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 [...]
+== Implementation
The core framework (xref:core:metamodel:about.adoc[MetaModel] module) provides a default implementation, `o.a.i.core.metamodel.services.appfeat.ApplicationFeatureRepositoryDefault`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService.adoc
index 7eb34ec..3bdf522 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService.adoc
@@ -2,25 +2,11 @@
= 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 ag [...]
-:page-partial:
-This service provides a serializable 'bookmark' for any entity, and conversely to lookup an entity from a bookmark.
+include::system:generated:page$index/applib/services/bookmark/BookmarkService.adoc[]
-include::BookmarkService/hooks/introductory_notes.adoc[]
+include::BookmarkService/hooks/implementation.adoc[]
-== API
+include::BookmarkService/hooks/examples_and_usage.adoc[]
-include::system:generated:page$index/applib/services/bookmark/BookmarkService.adoc[leveloffset=+2]
-
-== Implementation
-
-include::BookmarkService/implementation.adoc[]
-
-== Usage Notes
-
-include::BookmarkService/hooks/usage_notes.adoc[]
-
-== See Also
-
-include::BookmarkService/hooks/see_also.adoc[]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/usage_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/examples_and_usage.adoc
similarity index 54%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/usage_notes.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/examples_and_usage.adoc
index c209110..bb4982e 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/usage_notes.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/examples_and_usage.adoc
@@ -3,6 +3,9 @@
:page-partial:
+
+== Usage
+
There are two mixins that will contribute to this interface:
* xref:system:generated:index/applib/services/bookmark/BookmarkHolder_lookup.adoc[BookmarkHolder_lookup]
@@ -15,3 +18,24 @@ which contributes instead an `object` property, being the referenced object.
Either of these can be suppressed, if required, using a vetoing subscriber that listens to the action or property domain event in order to hide the member.
+
+// TODO: v2 - to fix up links.
+
+//== Examples
+//
+//For example, a `Customer` object with an xref:refguide:applib-ant:DomainObject.adoc#objectType[object type] of "custmgmt.Customer" and an id of 123
+//would correspond to a xref:BookmarkService.adoc#bookmark[`Bookmark`] with a string representation of "custmgmt.Customer|123".
+//
+//Bookmarks are useful to store a reference to an arbitrary object, although be aware that there is no referential integrity.
+//
+//Several of the extension libraries use bookmarks.
+//For example the xref:refguide:applib-svc:AuditerService.adoc[`AuditerService`] uses bookmarks to identify the object that is being modified.
+//
+//Serialized form of bookmarks also appear within xref:refguide:schema:about.adoc[schema] instances, for example as used by xref:refguide:applib-svc:CommandServiceInternal.adoc[`CommandService`] and the xref:refguide:applib-svc:ExecutionSubscriber.adoc[`PublisherService`].
+
+
+== See Also
+
+* xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]
+* xref:system:generated:index/applib/services/bookmark/BookmarkHolder.adoc[BookmarkHolder]
+
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/implementation.adoc
similarity index 98%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/implementation.adoc
index f37eb29..70d3821 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/implementation.adoc
@@ -3,5 +3,7 @@
+== Implementation
+
The core framework (xref:core:runtime-services:about.adoc[Runtime Services] module) provides a default implementation of this API, namely `o.a.i.core.runtimeservices.bookmarks.BookmarkServiceDefault`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/introductory_notes.adoc
deleted file mode 100644
index c256f6d..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,13 +0,0 @@
-
-: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 [...]
-
-
-For example, a `Customer` object with an xref:refguide:applib-ant:DomainObject.adoc#objectType[object type] of "custmgmt.Customer" and an id of 123
-would correspond to a xref:BookmarkService.adoc#bookmark[`Bookmark`] with a string representation of "custmgmt.Customer|123".
-
-Bookmarks are useful to store a reference to an arbitrary object, although be aware that there is no referential integrity.
-
-Several of the extension libraries use bookmarks.
-For example the xref:refguide:applib-svc:AuditerService.adoc[`AuditerService`] uses bookmarks to identify the object that is being modified.
-
-Serialized form of bookmarks also appear within xref:refguide:schema:about.adoc[schema] instances, for example as used by xref:refguide:applib-svc:CommandServiceInternal.adoc[`CommandService`] and the xref:refguide:applib-svc:ExecutionSubscriber.adoc[`PublisherService`].
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/see_also.adoc
deleted file mode 100644
index b2aa7b4..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/hooks/see_also.adoc
+++ /dev/null
@@ -1,6 +0,0 @@
-
-: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 [...]
-
-* xref:system:generated:index/applib/services/bookmark/Bookmark.adoc[Bookmark]
-* xref:system:generated:index/applib/services/bookmark/BookmarkHolder.adoc[BookmarkHolder]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService.adoc
index 8e60378..cc0de4c 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService.adoc
@@ -2,19 +2,12 @@
= BookmarkUiService
: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:
-The `BookmarkUiService` provides the ability to programmatically interact with bookmarked pages and breadcrumbs, as rendered by the Wicket viewer.
+include::system:generated:page$index/applib/services/bookmarkui/BookmarkUiService.adoc[]
+include::BookmarkUiService/hooks/implementation.adoc[]
-== API
-
-include::system:generated:page$index/applib/services/bookmarkui/BookmarkUiService.adoc[leveloffset=+2]
-
-
-== Implementation
-
-include::BookmarkUiService/implementation.adoc[]
+include::BookmarkUiService/hooks/examples_and_usage.adoc[]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/implementation.adoc
similarity index 97%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/implementation.adoc
index 54fdef9..28005a4 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/implementation.adoc
@@ -2,4 +2,6 @@
: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 [...]
+== Implementation
+
The xref:vw:ROOT:about.adoc[Wicket viewer] provides an implementation of this service, `o.a.i.viewer.wicket.viewer.services.BookmarkUiServiceWicket`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService.adoc
index 036aba1..b6ec58b 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService.adoc
@@ -2,22 +2,11 @@
= 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 ag [...]
-:page-partial:
-== API
+include::system:generated:page$index/applib/services/clock/ClockService.adoc[]
-include::system:generated:page$index/applib/services/clock/ClockService.adoc[leveloffset=+2]
+include::ClockService/hooks/implementation.adoc[]
-
-include::system:generated:page$index/applib/clock/VirtualClock.adoc[leveloffset=+2]
-
-== Implementation
-
-include::ClockService/implementation.adoc[]
-
-
-== Usage Notes
-
-include::ClockService/hooks/usage_notes.adoc[]
+include::ClockService/hooks/examples_and_usage.adoc[]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/usage_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/examples_and_usage.adoc
similarity index 94%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/usage_notes.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/examples_and_usage.adoc
index 3db7848..98c143c 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/usage_notes.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/examples_and_usage.adoc
@@ -2,7 +2,7 @@
: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 [...]
-
+== Usage
Most applications deal with dates and times in one way or another.
For example, if an `Order` is placed, then the `Customer` may have 30 days to pay the `Invoice`, otherwise a penalty may be levied.
@@ -15,3 +15,8 @@ While instantiating a `java.util.Date` to current the current time is painless e
Therefore it's common to provide a domain service whose responsibility is to provide the current time.
This service can be injected into any domain object (and can be mocked out for unit testing).
Apache Isis provides such a facade through the `ClockService`.
+
+
+== See also
+
+* xref:system:generated:index/applib/clock/VirtualClock.adoc[VirtualClock]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/implementation.adoc
index 2f50985..b229598 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/implementation.adoc
@@ -2,5 +2,6 @@
: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 [...]
+== Implementation
Note that this domain service is also used by the framework itself to obtain the time, so it acts as an SPI as well.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/introductory_notes.adoc
deleted file mode 100644
index ca04c21..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,2 +0,0 @@
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService.adoc
index 0189f3d..769597a 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService.adoc
@@ -4,13 +4,10 @@
: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 [...]
-== API
+include::system:generated:page$index/applib/services/commanddto/processor/spi/CommandDtoProcessorService.adoc[]
-include::system:generated:page$index/applib/services/commanddto/processor/spi/CommandDtoProcessorService.adoc[leveloffset=+2]
+include::CommandDtoProcessorService/hooks/implementation.adoc[]
-
-== See also
-
-include::CommandDtoProcessorService/hooks/see_also.adoc[]
+include::CommandDtoProcessorService/hooks/examples_and_usage.adoc[]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/examples_and_usage.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/examples_and_usage.adoc
new file mode 100644
index 0000000..6790e21
--- /dev/null
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/examples_and_usage.adoc
@@ -0,0 +1,19 @@
+
+: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 [...]
+
+
+== Usage
+
+Having a DTO representation of ``Command``s (or more precisely, any object implementing `HasCommandDto` offers the ability to move or copy it across the network, for example to support replay scenarios.
+This is used for example by xref:extensions:command-log:about.adoc[Command Log] extension to return persisted representations of commands.
+The conversion is performed by an in-built implementation of the xref:refguide:applib-svc:ContentMappingService.adoc[`ContentMappingService`] SPI.
+
+The `CommandDtoProcessorService` SPI provides a mechanism to post-process the `CommandDto` of any objects being serialized across the network.
+
+For example, the xref:extensions:command-replay:about.adoc[Command Replay] extension provides an implementation in order to copy information about the outcome of each command on the primary system into the `userData` map of `CommandDto`.
+Another use case is to strip out large blobs for performance reasons.
+
+
+== See also
+
+* xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc[CommandDtoProcessor]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/implementation.adoc
similarity index 88%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/implementation.adoc
index e4852a7..b0cfdc9 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/implementation.adoc
@@ -3,3 +3,6 @@
+== Implementation
+
+This is an SPI; there is no default implementation provided by the framework.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/see_also.adoc
deleted file mode 100644
index 171a3d0..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/hooks/see_also.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-
-: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 [...]
-
-
-* xref:system:generated:index/applib/services/commanddto/processor/CommandDtoProcessor.adoc[CommandDtoProcessor]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService.adoc
index dbe643a..71926d9 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService.adoc
@@ -2,50 +2,11 @@
= CommandExecutorService
: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:
+include::system:generated:page$index/applib/services/command/CommandExecutorService.adoc[]
-The `CommandExecutorService` domain service is provides the ability to execute a specified `Command`, optionally running the command with the identity of the user captured in that `Command`.
+include::CommandExecutorService/hooks/implementation.adoc[]
-In fact, the service requires that the implementation of the `Command` being executed implements the `CommandWithDto` sub-interface.
-This allows the xref:refguide:schema:cmd.adoc[`CommandDto`] memento to be extracted, from which the action can be invoked/property edited.
+include::CommandExecutorService/hooks/examples_and_usage.adoc[]
-The primary use case for this service is to allow the replay of commands, eg for regression testing.
-This is implemented by the (non-ASF) link:https://platform.incode.org/modules/spi/command/spi-command-replay.html[command replay module].
-(The command replay module also provides a decorator implementation of this service that allows the command to be re-executed at the same _time_ as the original command, leveraging the `TickingClock` implementation provided by the framework).
-
-
-== API
-
-The `CommandExecutorService` defines the following API:
-
-[source,java]
-----
-public interface CommandExecutorService {
- enum SudoPolicy {
- NO_SWITCH,
- SWITCH,
- }
- void executeCommand(
- SudoPolicy sudoPolicy, // <.>
- CommandWithDto commandWithDto); // <.>
-}
-----
-<.> whether to switch the effective user for the duration of executing the `Command`.
-Behind the scenes this uses the xref:refguide:applib-svc:SudoService.adoc[`SudoService`].
-<.> provided `Command` must implement `CommandDto`.
-
-When the `Command` is executed, it can also be accessed from the `Interaction` obtained by xref:refguide:applib-svc:InteractionContext.adoc[`InteractionContext`].
-Any associated objects that implement `HasUniqueId` (audit entries and the like) will therefore have the correct uniqueId and will correctly be associated with the `Command` being executed.
-
-== Implementation
-
-The framework provides a default implementation of this service,
-`o.a.i.core.runtime.services.background.CommandExecutorServiceDefault`
-
-
-
-== Related Services
-
-WARNING: TODO v2
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/_summary.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/_summary.adoc
new file mode 100644
index 0000000..baeb217
--- /dev/null
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/_summary.adoc
@@ -0,0 +1,10 @@
+// TODO - v2 (reconcile/move into javadoc).
+
+
+//<.> whether to switch the effective user for the duration of executing the `Command`.
+//Behind the scenes this uses the xref:refguide:applib-svc:SudoService.adoc[`SudoService`].
+//<.> provided `Command` must implement `CommandDto`.
+//
+//When the `Command` is executed, it can also be accessed from the `Interaction` obtained by xref:refguide:applib-svc:InteractionContext.adoc[`InteractionContext`].
+//Any associated objects that implement `HasUniqueId` (audit entries and the like) will therefore have the correct uniqueId and will correctly be associated with the `Command` being executed.
+
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/examples_and_usage.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/examples_and_usage.adoc
new file mode 100644
index 0000000..2a67bae
--- /dev/null
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/examples_and_usage.adoc
@@ -0,0 +1,18 @@
+
+: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 [...]
+
+
+
+== Usage
+
+The `CommandExecutorService` domain service is provides the ability to execute a specified `Command`, optionally running the command with the identity of the user captured in that `Command`.
+
+
+// TODO - v2 this is out of date; reference the command-replay service, now part of framework.
+
+//In fact, the service requires that the implementation of the `Command` being executed implements the `CommandWithDto` sub-interface.
+//This allows the xref:refguide:schema:cmd.adoc[`CommandDto`] memento to be extracted, from which the action can be invoked/property edited.
+//
+//The primary use case for this service is to allow the replay of commands, eg for regression testing.
+//This is implemented by the (non-ASF) link:https://platform.incode.org/modules/spi/command/spi-command-replay.html[command replay module].
+//(The command replay module also provides a decorator implementation of this service that allows the command to be re-executed at the same _time_ as the original command, leveraging the `TickingClock` implementation provided by the framework).
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/implementation.adoc
similarity index 83%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/implementation.adoc
index e4852a7..702c876 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/implementation.adoc
@@ -2,4 +2,8 @@
: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 [...]
+== Implementation
+
+The framework provides a default implementation of this service,
+`o.a.i.core.runtimeservices.command.CommandExecutorServiceDefault`
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber.adoc
index 50c6aa5..fec1a2c 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber.adoc
@@ -5,5 +5,8 @@
:page-partial:
-CAUTION: TODO - v2 - to update, has been simplified.
+include::system:generated:page$index/applib/services/publishing/spi/CommandSubscriber.adoc[]
+include::CommandSubscriber/hooks/implementation.adoc[]
+
+include::CommandSubscriber/hooks/examples_and_usage.adoc[]
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/implementation.adoc
similarity index 80%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/implementation.adoc
index e53b262..8df9d86 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/implementation.adoc
@@ -3,6 +3,8 @@
-The xref:vro:ROOT:about.adoc[Restful Objects] viewer provides an implementation of this API, `o.a.i.viewer.restfulobjects.rendering.service.acceptheader.AcceptHeaderServiceForRest`.
+== Implementation
+This is intended as an SPI.
+The framework does however provides a simple implementation that just logs the commands: `o.a.i.applib.services.publishing.log.CommandLogger`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu.adoc
index 2169ae4..c4bcfec 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu.adoc
@@ -2,32 +2,13 @@
= ConfigurationMenu
: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:
-The `ConfigurationMenu` service simply provides a UI in order to access the configuration properties available from xref:refguide:applib-svc:ConfigurationViewService.adoc[`ConfigurationViewService`].
-== API
-include::system:generated:page$index/ConfigurationMenu.adoc[leveloffset=+2]
+include::system:generated:page$index/applib/services/confview/ConfigurationMenu.adoc[]
-TODO example migration
+include::ConfigurationMenu/hooks/implementation.adoc[]
-.Deprecated Docs
-[WARNING]
-================================
+include::ConfigurationMenu/hooks/examples_and_usage.adoc[]
-== Implementation
-The `ConfigurationMenu` implementation is very simple (annotations omitted):
-
-[source,java]
-----
-include::refguide:applib-svc:example$services/confview/ConfigurationMenu.java[tags="refguide"]
-----
-
-
-================================
-
-== Related Services
-
-This service is the front-end UI (and delegates to) xref:refguide:applib-svc:ConfigurationViewService.adoc[`ConfigurationViewService`].
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/examples_and_usage.adoc
similarity index 83%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/examples_and_usage.adoc
index 2f50985..1535df4 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/examples_and_usage.adoc
@@ -2,5 +2,6 @@
: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 [...]
+== Related Services
-Note that this domain service is also used by the framework itself to obtain the time, so it acts as an SPI as well.
+This service is the front-end UI (and delegates to) xref:refguide:applib-svc:ConfigurationViewService.adoc[`ConfigurationViewService`].
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/implementation.adoc
similarity index 89%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/implementation.adoc
index e4852a7..f419bda 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/implementation.adoc
@@ -3,3 +3,6 @@
+== Implementation
+
+This service is a concrete class, so provides its own implementation.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService.adoc
index f1c5e27..a8ec4e8 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService.adoc
@@ -4,65 +4,11 @@
: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:
-The `ConfigurationViewService` is the backing service for xref:ConfigurationMenu.adoc[`ConfigurationMenu`].
-It simply returns a `ConfigurationProperty` (view model) instance for all known `isis.\*` and `resteasy.*` configuration properties.
+include::system:generated:page$index/applib/services/confview/ConfigurationViewService.adoc[]
+include::ConfigurationViewService/hooks/implementation.adoc[]
-== API
+include::ConfigurationViewService/hooks/examples_and_usage.adoc[]
-include::system:generated:page$index/applib/services/confview/ConfigurationProperty.adoc[leveloffset=+2]
-
-TODO example migration
-
-.Deprecated Docs
-[WARNING]
-================================
-
-== API
-
-The API defined by this service is very simple:
-
-[source,java]
-----
-include::refguide:applib-svc:example$services/confview/ConfigurationViewService.java[tags="refguide"]
-----
-
-where `ConfigurationProperty` is a view model:
-
-[source,java]
-----
-include::refguide:applib-svc:example$services/confview/ConfigurationProperty.java[tags="refguide"]
-----
-
-
-================================
-
-== Implementation
-
-The core framework (xref:core:runtime-services:about.adoc[Runtime Services] module) provides a default implementation of this API, namely `o.a.i.core.runtimeservices.confmenu.ConfigurationViewServiceDefault`.
-
-
-
-== Related Services
-
-* The configuration properties for Apache Isis can also be obtained from the xref:refguide:config:about.adoc#isisconfiguration-domain-service[`IsisConfiguration`] domain service.
-These provide link:https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot-features-external-config-typesafe-configuration-properties[type-safe] access to all `isis.*` configuration properties.
-+
-[NOTE]
-====
-`IsisConfiguration` is part of xref:refguide:config:about.adoc[`isis-core-config`] rather than the applib.
-
-To use it therefore requires this dependency:
-[source,xml]
-.pom.xml
-----
-<dependency>
- <groupId>org.apache.isis.core</groupId>
- <artifactId>isis-core-config</artifactId>
-</dependency>
-----
-====
-
-* The xref:refguide:applib-svc:ConfigurationMenu.adoc[ `ConfigurationMenu`] provides a UI to access this service.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/examples_and_usage.adoc
similarity index 59%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/examples_and_usage.adoc
index f1c5e27..c38b971 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/examples_and_usage.adoc
@@ -1,47 +1,5 @@
-[#ConfigurationViewService]
-= ConfigurationViewService
: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:
-
-The `ConfigurationViewService` is the backing service for xref:ConfigurationMenu.adoc[`ConfigurationMenu`].
-
-It simply returns a `ConfigurationProperty` (view model) instance for all known `isis.\*` and `resteasy.*` configuration properties.
-
-
-== API
-
-include::system:generated:page$index/applib/services/confview/ConfigurationProperty.adoc[leveloffset=+2]
-
-TODO example migration
-
-.Deprecated Docs
-[WARNING]
-================================
-
-== API
-
-The API defined by this service is very simple:
-
-[source,java]
-----
-include::refguide:applib-svc:example$services/confview/ConfigurationViewService.java[tags="refguide"]
-----
-
-where `ConfigurationProperty` is a view model:
-
-[source,java]
-----
-include::refguide:applib-svc:example$services/confview/ConfigurationProperty.java[tags="refguide"]
-----
-
-
-================================
-
-== Implementation
-
-The core framework (xref:core:runtime-services:about.adoc[Runtime Services] module) provides a default implementation of this API, namely `o.a.i.core.runtimeservices.confmenu.ConfigurationViewServiceDefault`.
-
== Related Services
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/implementation.adoc
similarity index 89%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/implementation.adoc
index f37eb29..9410bd6 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/implementation.adoc
@@ -3,5 +3,7 @@
-The core framework (xref:core:runtime-services:about.adoc[Runtime Services] module) provides a default implementation of this API, namely `o.a.i.core.runtimeservices.bookmarks.BookmarkServiceDefault`.
+== Implementation
+
+The core framework (xref:core:runtime-services:about.adoc[Runtime Services] module) provides a default implementation of this API, namely `o.a.i.core.runtimeservices.confmenu.ConfigurationViewServiceDefault`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/implementation.adoc
deleted file mode 100644
index e4852a7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/implementation.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-
-: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 [...]
-
-
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService.adoc
index 3ddf78d..826848a 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService.adoc
@@ -2,76 +2,10 @@
= 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 ag [...]
-:page-partial:
-// TODO: this is an SPI, so maybe restfulobjects should define an "spi" module for this.
+include::system:generated:page$index/applib/services/conmap/ContentMappingService.adoc[]
-The `ContentMappingService` supports the (default implementation of the) internal xref:core:runtime-services:ContentNegotiationService.adoc[`ContentNegotiationService`] SPI enabling the xref:vro:ROOT:about.adoc[RestfulObjects viewer] to represent domain objects in some other format as specified by the HTTP `Accept` header.
+include::ContentMappingService/hooks/implementation.adoc[]
-For its part, the (default implementation of the) `ContentNegotiationService` will check _all_ available implementations of `ContentMappingService` to convert the domain object to the requested media type, rather than merely the first implementation found; in other words it uses the link:https://en.wikipedia.org/wiki/Chain-of-responsibility_pattern[chain-of-responsibility] pattern.
-Services are checked in the ordering defined by the Spring link:https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/core/annotation/Order.html[`@Order`] annotation.
-The mapped object used will be the first non-`null` result returned by an implementation.
+include::ContentMappingService/hooks/examples_and_usage.adoc[]
-
-
-== API
-
-include::system:generated:page$index/applib/services/conmap/ContentMappingService.adoc[leveloffset=+2]
-
-TODO example migration
-
-.Deprecated Docs
-[WARNING]
-================================
-
-== SPI
-
-The SPI defined by this service is:
-
-[source,java]
-----
-include::refguide:applib-svc:example$services/conmap/ContentMappingService.java[tags="refguide"]
-----
-<.> typically the input is a domain object (whose structure might change over time), and the output is a DTO (whose structure is guaranteed to be preserved over time)
-<.> as per the caller's HTTP `Accept` header
-
-
-
-
-
-================================
-
-== Implementations
-
-The framework provides two implementations of this service, both to allow objects implementing `HasCommandDto` to be converted into serializable ``CommandDto``s, in other words XML.
-This is used by the xref:extensions:command-log:about.adoc[Command Log] and xref:extensions:command-replay:about.adoc[Command Replay] extensions to allow commands to be replicated from a primary to secondary system, for regression testing.
-
-The implementations are:
-
-* `o.a.i.applib.services.commanddto.conmap.ContentMappingServiceForCommandDto` will map any single instance of a `HasCommandDto` into a `CommandDto` XML document
-* `o.a.i.applib.services.commanddto.conmap.ContentMappingServiceForCommandsDto` will map a list of ``HasCommandDto``s into a `CommandsDto` XML document, and will wrap any single instance of a `CommandWithDto` into a singleton list and thence into a `CommandsDto` XML document.
-
-If the action invocation or property edit represent provides an implementation of a `CommandDtoProcessor` (by way of xref:refguide:applib-ant:Action.adoc#command[`@Action#commandDtoProcessor()`] or xref:refguide:applib-ant:Property.adoc#command[`@Property#commandDtoProcessor()`]) then this is also called to post-process the persisted `CommandDto` if required.
-A typical use case for this is to dynamically add in serialized ``Blob``s or ``Clob``s, the values of which are not captured by default in `CommandDto`.
-
-To support the writing of custom implementations of this interface, the framework also provides `ContentMappingService.Util` which includes a couple of convenience utilities:
-
-[source,java]
-----
-public static class Util {
- public static String determineDomainType(
- final List<MediaType> acceptableMediaTypes) { /* ... */ }
- public static boolean isSupported(
- final Class<?> clazz,
- final List<MediaType> acceptableMediaTypes) { /* ... */ }
-}
-----
-
-
-
-
-== Related Services
-
-This service is a companion to the default implementation of the xref:core:runtime-services:ContentNegotiationService.adoc[`ContentNegotiationService`].
-
-The framework implementations of `ContentMappingService` use the xref:refguide:applib-svc:MetamodelService.adoc[`MetaModelService`] to lookup any custom implementations of `CommandDtoProcessor`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/_summary.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/_summary.adoc
new file mode 100644
index 0000000..e0ce9c5
--- /dev/null
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/_summary.adoc
@@ -0,0 +1,5 @@
+// TODO - v2 (reconcile/move into javadoc).
+
+//
+//<.> typically the input is a domain object (whose structure might change over time), and the output is a DTO (whose structure is guaranteed to be preserved over time)
+//<.> as per the caller's HTTP `Accept` header
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/examples_and_usage.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/examples_and_usage.adoc
new file mode 100644
index 0000000..86a24fa
--- /dev/null
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/examples_and_usage.adoc
@@ -0,0 +1,20 @@
+
+: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 [...]
+
+
+== Usage
+
+// TODO: v2: this is an SPI, so maybe restfulobjects should define an "spi" module for this.
+
+The `ContentMappingService` supports the (default implementation of the) internal xref:core:runtime-services:ContentNegotiationService.adoc[`ContentNegotiationService`] SPI enabling the xref:vro:ROOT:about.adoc[RestfulObjects viewer] to represent domain objects in some other format as specified by the HTTP `Accept` header.
+
+For its part, the (default implementation of the) `ContentNegotiationService` will check _all_ available implementations of `ContentMappingService` to convert the domain object to the requested media type, rather than merely the first implementation found; in other words it uses the link:https://en.wikipedia.org/wiki/Chain-of-responsibility_pattern[chain-of-responsibility] pattern.
+Services are checked in the ordering defined by the Spring link:https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/core/annotation/Order.html[`@Order`] annotation.
+The mapped object used will be the first non-`null` result returned by an implementation.
+
+
+== Related Services
+
+This service is a companion to the default implementation of the xref:core:runtime-services:ContentNegotiationService.adoc[`ContentNegotiationService`].
+
+The framework implementations of `ContentMappingService` use the xref:refguide:applib-svc:MetamodelService.adoc[`MetaModelService`] to lookup any custom implementations of `CommandDtoProcessor`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/implementation.adoc
similarity index 50%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/implementation.adoc
index 3ddf78d..6ba8603 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/implementation.adoc
@@ -1,47 +1,9 @@
-[#ContentMappingService]
-= 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 ag [...]
-:page-partial:
-// TODO: this is an SPI, so maybe restfulobjects should define an "spi" module for this.
-The `ContentMappingService` supports the (default implementation of the) internal xref:core:runtime-services:ContentNegotiationService.adoc[`ContentNegotiationService`] SPI enabling the xref:vro:ROOT:about.adoc[RestfulObjects viewer] to represent domain objects in some other format as specified by the HTTP `Accept` header.
-For its part, the (default implementation of the) `ContentNegotiationService` will check _all_ available implementations of `ContentMappingService` to convert the domain object to the requested media type, rather than merely the first implementation found; in other words it uses the link:https://en.wikipedia.org/wiki/Chain-of-responsibility_pattern[chain-of-responsibility] pattern.
-Services are checked in the ordering defined by the Spring link:https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/core/annotation/Order.html[`@Order`] annotation.
-The mapped object used will be the first non-`null` result returned by an implementation.
-
-
-
-== API
-
-include::system:generated:page$index/applib/services/conmap/ContentMappingService.adoc[leveloffset=+2]
-
-TODO example migration
-
-.Deprecated Docs
-[WARNING]
-================================
-
-== SPI
-
-The SPI defined by this service is:
-
-[source,java]
-----
-include::refguide:applib-svc:example$services/conmap/ContentMappingService.java[tags="refguide"]
-----
-<.> typically the input is a domain object (whose structure might change over time), and the output is a DTO (whose structure is guaranteed to be preserved over time)
-<.> as per the caller's HTTP `Accept` header
-
-
-
-
-
-================================
-
-== Implementations
+== Implementation
The framework provides two implementations of this service, both to allow objects implementing `HasCommandDto` to be converted into serializable ``CommandDto``s, in other words XML.
This is used by the xref:extensions:command-log:about.adoc[Command Log] and xref:extensions:command-replay:about.adoc[Command Replay] extensions to allow commands to be replicated from a primary to secondary system, for regression testing.
@@ -51,7 +13,7 @@ The implementations are:
* `o.a.i.applib.services.commanddto.conmap.ContentMappingServiceForCommandDto` will map any single instance of a `HasCommandDto` into a `CommandDto` XML document
* `o.a.i.applib.services.commanddto.conmap.ContentMappingServiceForCommandsDto` will map a list of ``HasCommandDto``s into a `CommandsDto` XML document, and will wrap any single instance of a `CommandWithDto` into a singleton list and thence into a `CommandsDto` XML document.
-If the action invocation or property edit represent provides an implementation of a `CommandDtoProcessor` (by way of xref:refguide:applib-ant:Action.adoc#command[`@Action#commandDtoProcessor()`] or xref:refguide:applib-ant:Property.adoc#command[`@Property#commandDtoProcessor()`]) then this is also called to post-process the persisted `CommandDto` if required.
+If the action invocation or property edit represent provides an implementation of a `CommandDtoProcessor` (by way of xref:refguide:applib-ant:Action.adoc#commandDtoProcessor[`@Action#commandDtoProcessor()`] or xref:refguide:applib-ant:Property.adoc#commandDtoProcessor[`@Property#commandDtoProcessor()`]) then this is also called to post-process the persisted `CommandDto` if required.
A typical use case for this is to dynamically add in serialized ``Blob``s or ``Clob``s, the values of which are not captured by default in `CommandDto`.
To support the writing of custom implementations of this interface, the framework also provides `ContentMappingService.Util` which includes a couple of convenience utilities:
@@ -68,10 +30,3 @@ public static class Util {
----
-
-
-== Related Services
-
-This service is a companion to the default implementation of the xref:core:runtime-services:ContentNegotiationService.adoc[`ContentNegotiationService`].
-
-The framework implementations of `ContentMappingService` use the xref:refguide:applib-svc:MetamodelService.adoc[`MetaModelService`] to lookup any custom implementations of `CommandDtoProcessor`.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/implementation.adoc
deleted file mode 100644
index e4852a7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/implementation.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-
-: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 [...]
-
-
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService.adoc
index 785e050..9791c7a 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService.adoc
@@ -4,6 +4,7 @@
: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:
+
The `DeepLinkService` provides the ability to obtain a `java.net.URI` that links to a representation of any (persisted) domain entity or view model.
A typical use case is to generate a clickable link for rendering in an email, PDF, tweet or other communication.
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/implementation.adoc
deleted file mode 100644
index e4852a7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/implementation.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-
-: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 [...]
-
-
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/implementation.adoc
similarity index 97%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/implementation.adoc
deleted file mode 100644
index e4852a7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailNotificationService/implementation.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-
-: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 [...]
-
-
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/DeepLinkService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/implementation.adoc
similarity index 97%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/implementation.adoc
deleted file mode 100644
index e4852a7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/EmailService/implementation.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-
-: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 [...]
-
-
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ContentMappingService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/implementation.adoc
similarity index 97%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/implementation.adoc
deleted file mode 100644
index e4852a7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/ErrorReportingService/implementation.adoc
+++ /dev/null
@@ -1,5 +0,0 @@
-
-: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 [...]
-
-
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationViewService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/introductory_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/introductory_notes.adoc
deleted file mode 100644
index 9e0d1b7..0000000
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/introductory_notes.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-
-: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 [...]
-
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizer/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ConfigurationMenu/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizer/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizer/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizer/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizer/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizerService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/CommandSubscriber/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizerService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizerService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizerService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ExceptionRecognizerService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ExecutionSubscriber/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/CommandExecutorService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/ExecutionSubscriber/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ExecutionSubscriber/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ExecutionSubscriber/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ExecutionSubscriber/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/FactoryService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ClockService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/FactoryService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/FactoryService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/FactoryService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/FactoryService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/usage_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/GridLoaderService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/usage_notes.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/GridLoaderService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/GridLoaderService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/GridLoaderService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/GridLoaderService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/GridService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/BookmarkUiService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/GridService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/GridService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/GridService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/GridService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/usage_notes.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/GridSystemService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/ApplicationFeatureRepository/hooks/usage_notes.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/GridSystemService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/GridSystemService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/GridSystemService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/GridSystemService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/HealthCheckService/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/AcceptHeaderService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/HealthCheckService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/HealthCheckService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/HealthCheckService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/HealthCheckService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/HintStore/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/HintStore/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/HintStore/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/HintStore/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/HintStore/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/HomePageResolverService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/HomePageResolverService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/HomePageResolverService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/HomePageResolverService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/HomePageResolverService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/InteractionContext/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/InteractionContext/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/InteractionContext/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/InteractionContext/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/InteractionContext/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/JaxbService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/JaxbService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/JaxbService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/JaxbService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/JaxbService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/LayoutService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/LayoutService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/LayoutService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/LayoutService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/LayoutService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/LayoutServiceMenu/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/LayoutServiceMenu/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/LayoutServiceMenu/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/LayoutServiceMenu/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/LayoutServiceMenu/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/LocaleProvider/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/LocaleProvider/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/LocaleProvider/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/LocaleProvider/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/LocaleProvider/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsLoaderService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsLoaderService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsLoaderService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsLoaderService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsLoaderService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/MenuBarsService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MessageService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MessageService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MessageService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MessageService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/MessageService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelServiceMenu/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelServiceMenu/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelServiceMenu/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelServiceMenu/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/MetaModelServiceMenu/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MetricsService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MetricsService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/MetricsService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/MetricsService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/MetricsService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCache/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCache/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCache/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCache/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCache/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCacheControl/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCacheControl/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCacheControl/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCacheControl/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/QueryResultsCacheControl/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/RepositoryService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/RepositoryService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/RepositoryService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/RepositoryService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/RepositoryService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/RoutingService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/RoutingService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/RoutingService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/RoutingService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/RoutingService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/Scratchpad/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/Scratchpad/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/Scratchpad/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/Scratchpad/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/Scratchpad/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ServiceInjector/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ServiceInjector/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ServiceInjector/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ServiceInjector/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ServiceInjector/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ServiceRegistry/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ServiceRegistry/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/ServiceRegistry/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/ServiceRegistry/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/ServiceRegistry/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/SessionLoggingService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/SessionLoggingService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/SessionLoggingService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/SessionLoggingService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/SessionLoggingService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/SudoService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/SudoService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/SudoService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/SudoService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/SudoService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/SwaggerService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/SwaggerService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/SwaggerService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/SwaggerService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/SwaggerService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TableColumnOrderService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TableColumnOrderService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TableColumnOrderService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TableColumnOrderService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/TableColumnOrderService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TitleService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TitleService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TitleService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TitleService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/TitleService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TransactionService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TransactionService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TransactionService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TransactionService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/TransactionService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TranslationService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TranslationService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TranslationService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TranslationService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/TranslationService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TranslationsResolver/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TranslationsResolver/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/TranslationsResolver/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/TranslationsResolver/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/TranslationsResolver/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UrlEncodingService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UrlEncodingService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UrlEncodingService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UrlEncodingService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/UrlEncodingService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UserProfileService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UserProfileService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UserProfileService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UserProfileService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/UserProfileService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UserRegistrationService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UserRegistrationService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UserRegistrationService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UserRegistrationService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/UserRegistrationService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UserService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UserService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/UserService/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/UserService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/UserService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/WrapperFactory/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/WrapperFactory/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/WrapperFactory/hooks/implementation.adoc
similarity index 97%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/WrapperFactory/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/WrapperFactory/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/XmlService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/XmlService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/XmlService/hooks/implementation.adoc
similarity index 97%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/XmlService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/CommandDtoProcessorService/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/XmlService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/XmlSnapshotService/hooks/examples_and_usage.adoc
similarity index 100%
copy from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
copy to api/applib/src/main/adoc/modules/applib-svc/pages/XmlSnapshotService/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/XmlSnapshotService/hooks/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/XmlSnapshotService/hooks/implementation.adoc
index e4852a7..697f559 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/XmlSnapshotService/hooks/implementation.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/XmlSnapshotService/hooks/implementation.adoc
@@ -3,3 +3,4 @@
+== Implementation
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/about/hooks/examples_and_usage.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/hooks/see_also.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/about/hooks/examples_and_usage.adoc
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/implementation.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/about/hooks/implementation.adoc
similarity index 100%
rename from api/applib/src/main/adoc/modules/applib-svc/pages/EventBusService/implementation.adoc
rename to api/applib/src/main/adoc/modules/applib-svc/pages/about/hooks/implementation.adoc
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/commanddto/processor/spi/CommandDtoProcessorService.java b/api/applib/src/main/java/org/apache/isis/applib/services/commanddto/processor/spi/CommandDtoProcessorService.java
index 59f9937..8b8227e 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/commanddto/processor/spi/CommandDtoProcessorService.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/commanddto/processor/spi/CommandDtoProcessorService.java
@@ -42,6 +42,16 @@ import org.apache.isis.schema.cmd.v2.CommandDto;
public interface CommandDtoProcessorService {
/**
+ * Converts the domain object (acting as the source) into a {@link CommandDto}.
+ *
+ * <p>
+ * The {@link CommandDto} that is also passed into the method will be
+ * from a default implementation provided by the framework. Most
+ * implementations will typically refine this provided DTO and return,
+ * for example adding additional user metadata to
+ * {@link CommandDto#getUserData()}.
+ * </p>
+ *
* @param domainObject - is the target that acts as the source of the
* {@link CommandDto}.
* @param commandDto - is either <code>null</code>, or is passed from a
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationMenu.java b/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationMenu.java
index e4ce41d..17b776f 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationMenu.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationMenu.java
@@ -32,7 +32,12 @@ import org.apache.isis.applib.annotation.DomainServiceLayout;
import org.apache.isis.applib.annotation.MemberOrder;
import org.apache.isis.applib.annotation.SemanticsOf;
+import lombok.RequiredArgsConstructor;
+
/**
+ * Simply provides a UI in order to access the configuration properties
+ * available from {@link ConfigurationViewService}.
+ *
* @since 2.0 {@index}
*/
@Named("isis.applib.ConfigurationMenu")
diff --git a/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationViewService.java b/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationViewService.java
index 60604e8..0ca321e 100644
--- a/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationViewService.java
+++ b/api/applib/src/main/java/org/apache/isis/applib/services/confview/ConfigurationViewService.java
@@ -22,6 +22,14 @@ package org.apache.isis.applib.services.confview;
import java.util.Set;
/**
+ * Returns the configuration properties (as view models) such that they can
+ * be rendered into the UI (in the Wicket Viewer, under the "Configuration"
+ * menu).
+ *
+ * <p>
+ * This is the backing service used by {@link ConfigurationMenu}.
+ * </p>
+ *
* @since 2.0 {@index}
*/
public interface ConfigurationViewService {