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/03/06 06:49:25 UTC

[isis] 01/01: ISIS-2444: minor improvements on refguide

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

commit 8a135e61592c8990b45fbdfc584930bcbdccf49c
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Fri Mar 5 12:18:59 2021 +0000

    ISIS-2444: minor improvements on refguide
---
 .../modules/applib-ant/pages/about/jdo.adoc        | 36 +++++++++++-----------
 .../applib-classes/pages/events/domainevent.adoc   |  2 +-
 .../pages/events/lifecycleevent.adoc               | 27 ++++++----------
 .../applib-classes/pages/events/uievent.adoc       | 14 ++++-----
 .../modules/applib-methods/pages/lifecycle.adoc    | 19 +++++-------
 .../modules/applib-methods/pages/prefixes.adoc     | 14 +--------
 .../modules/applib-methods/pages/reserved.adoc     | 20 +-----------
 .../applib-methods/pages/reserved/cssClass.adoc    |  7 -----
 .../applib-methods/pages/reserved/iconName.adoc    |  8 -----
 .../applib-methods/pages/reserved/layout.adoc      |  9 +-----
 .../applib-methods/pages/reserved/title.adoc       | 10 ------
 .../modules/ROOT/pages/2020/2.0.0-M5/mignotes.adoc | 17 +++++++---
 core/adoc/modules/ROOT/partials/component-nav.adoc |  1 -
 .../isis.persistence.schema~post.adoc              |  3 ++
 .../section-hooks/isis.persistence.schema~pre.adoc |  4 +++
 15 files changed, 66 insertions(+), 125 deletions(-)

diff --git a/antora/components/refguide/modules/applib-ant/pages/about/jdo.adoc b/antora/components/refguide/modules/applib-ant/pages/about/jdo.adoc
index e6c4142..9995006 100644
--- a/antora/components/refguide/modules/applib-ant/pages/about/jdo.adoc
+++ b/antora/components/refguide/modules/applib-ant/pages/about/jdo.adoc
@@ -16,16 +16,16 @@ The table below lists the xref:pjdo:ROOT:about.adoc[JDO/DataNucleus] annotations
 |Applies to
 
 
-|xref:refguide:applib-ant:Column.adoc[`@javax.jdo.annotations.` +
-`Column`]
+|xref:refguide:applib-ant:Column.adoc[@javax.jdo.annotations. +
+Column]
 |Used to determine whether a property is mandatory or optional.  For `String` and `BigDecimal` properties, used to determine length/precision/scale.
 
 |Domain / persistence
 |Property
 
 
-|xref:refguide:applib-ant:Discriminator.adoc[`@javax.jdo.annotations.` +
-`Discriminator`]
+|xref:refguide:applib-ant:Discriminator.adoc[@javax.jdo.annotations. +
+Discriminator]
 |Override for the object type, as used in `Bookmark`s, URLs for xref:vro:ROOT:about.adoc[RestfulObjects viewer] and elsewhere. +
 
 Note that the discriminator overrides the object type that may otherwise be inferred from the xref:refguide:applib-ant:PersistenceCapable.adoc[@PersistenceCapable] annotation.
@@ -33,8 +33,8 @@ Note that the discriminator overrides the object type that may otherwise be infe
 |Class
 
 
-|xref:refguide:applib-ant:NotPersistent.adoc[`@javax.jdo.annotations.` +
-`NotPersistent`]
+|xref:refguide:applib-ant:NotPersistent.adoc[@javax.jdo.annotations. +
+NotPersistent]
 |Used to determine whether to enforce or skip some xref:userguide:btb:about.adoc#custom-validator[metamodel validation] for `@Column` versus equivalent Isis annotations.
 
 |Domain / persistence
@@ -42,8 +42,8 @@ Note that the discriminator overrides the object type that may otherwise be infe
 
 
 
-|xref:refguide:applib-ant:PersistenceCapable.adoc[`@javax.jdo.annotations.` +
-`PersistenceCapable`]
+|xref:refguide:applib-ant:PersistenceCapable.adoc[@javax.jdo.annotations. +
+PersistenceCapable]
 |Used to build Apache Isis' own internal identifier for objects. +
 
 If the `schema` attribute is specified (and if xref:refguide:applib-ant:Discriminator.adoc[@Discriminator] __hasn't__ been specified), is also used to derive the object type, as used in `Bookmark`s, URLs for xref:vro:ROOT:about.adoc[RestfulObjects viewer] and elsewhere.
@@ -52,8 +52,8 @@ If the `schema` attribute is specified (and if xref:refguide:applib-ant:Discrimi
 |Class
 
 
-|xref:refguide:applib-ant:PrimaryKey.adoc[`@javax.jdo.annotations.` +
-`PrimaryKey`]
+|xref:refguide:applib-ant:PrimaryKey.adoc[@javax.jdo.annotations. +
+PrimaryKey]
 |Used to ensure Apache Isis does not overwrite application-defined primary keys, and to ensure is read-only in the UI.
 
 |Domain / persistence
@@ -76,29 +76,29 @@ Isis also parses the following JDO annotations, but the metadata is currently un
 |Applies to
 
 
-|`@javax.jdo.annotations.` +
-`DataStoreIdentity`
+|@javax.jdo.annotations. +
+DataStoreIdentity
 |Unused
 |Persistence
 |Class
 
 
-|`@javax.jdo.annotations.` +
-`Queries`
+|@javax.jdo.annotations. +
+Queries
 |Unused
 |Persistence
 |Class
 
 
-|`@javax.jdo.annotations.` +
-`Query`
+|@javax.jdo.annotations. +
+Query
 |Unused
 |Persistence
 |Class
 
 
-|`@javax.jdo.annotations.` +
-`Version`
+|@javax.jdo.annotations. +
+Version
 |Unused
 |Persistence
 |Class
diff --git a/antora/components/refguide/modules/applib-classes/pages/events/domainevent.adoc b/antora/components/refguide/modules/applib-classes/pages/events/domainevent.adoc
index b5f9e1b..abbd34b 100644
--- a/antora/components/refguide/modules/applib-classes/pages/events/domainevent.adoc
+++ b/antora/components/refguide/modules/applib-classes/pages/events/domainevent.adoc
@@ -11,7 +11,7 @@ They allow subscribers to change either veto the interaction, or to trigger othe
 
 
 .Domain Event Classes
-[cols="2a,2a,2a", options="header"]
+[cols="2m,2m,2a", options="header"]
 |===
 
 |API
diff --git a/antora/components/refguide/modules/applib-classes/pages/events/lifecycleevent.adoc b/antora/components/refguide/modules/applib-classes/pages/events/lifecycleevent.adoc
index b6717b6..4116e98 100644
--- a/antora/components/refguide/modules/applib-classes/pages/events/lifecycleevent.adoc
+++ b/antora/components/refguide/modules/applib-classes/pages/events/lifecycleevent.adoc
@@ -12,12 +12,12 @@ One use case is to maintain an alternate data store.
 
 
 .Lifecycle Event Classes
-[cols="2a,2a,2a", options="header"]
+[cols="2m,2m,2a", options="header"]
 |===
 
 |API
-|Event class defined by
-|Raised when
+|Event class defined by xref:refguide:applib:index/annotation/DomainObject.adoc[@DomainObject]
+|Published when
 
 
 |xref:refguide:applib:index/events/lifecycle/AbstractLifecycleEvent.adoc[AbstractLifecycleEvent]
@@ -26,49 +26,42 @@ One use case is to maintain an alternate data store.
 
 
 |xref:refguide:applib:index/events/lifecycle/ObjectCreatedEvent.adoc[ObjectCreatedEvent]
-|xref:refguide:applib:index/annotation/DomainObject.adoc#createdLifecycleEvent[DomainObject +
-#createdLifecycleEvent()]
+|xref:refguide:applib:index/annotation/DomainObject.adoc#createdLifecycleEvent[createdLifecycleEvent()]
 |entity is first instantiated using  xref:refguide:applib:index/services/factory/FactoryService.adoc[FactoryService] +
 
 Also raised for view models.
 
 
 |xref:refguide:applib:index/events/lifecycle/ObjectLoadedEvent.adoc[ObjectLoadedEvent]
-|xref:refguide:applib:index/annotation/DomainObject.adoc#loadedLifecycleEvent[DomainObject +
-#loadedLifecycleEvent()]
+|xref:refguide:applib:index/annotation/DomainObject.adoc#loadedLifecycleEvent[loadedLifecycleEvent()]
 |entity is retrieved from the database.
 
 
 |xref:refguide:applib:index/events/lifecycle/ObjectPersistedEvent.adoc[ObjectPersistedEvent]
-|xref:refguide:applib:index/annotation/DomainObject.adoc#persistedLifecycleEvent[DomainObject +
-#persistedLifecycleEvent()]
+|xref:refguide:applib:index/annotation/DomainObject.adoc#persistedLifecycleEvent[persistedLifecycleEvent()]
 |entity is first saved (inserted) into the database using the xref:refguide:applib:index/services/repository/RepositoryService.adoc[RepositoryService]'s
 `#persist(...)` method.
 
 
 |xref:refguide:applib:index/events/lifecycle/ObjectPersistingEvent.adoc[ObjectPersistingEvent]
-|xref:refguide:applib:index/annotation/DomainObject.adoc#persistingLifecycleEvent[DomainObject +
-#persistingLifecycleEvent()]
+|xref:refguide:applib:index/annotation/DomainObject.adoc#persistingLifecycleEvent[persistingLifecycleEvent()]
 |entity is about to be saved (inserted) into the database using the xref:refguide:applib:index/services/repository/RepositoryService.adoc[RepositoryService]'s
 `#persist(...)` method.
 
 
 |xref:refguide:applib:index/events/lifecycle/ObjectRemovingEvent.adoc[ObjectRemovingEvent]
-|xref:refguide:applib:index/annotation/DomainObject.adoc#removingLifecycleEvent[DomainObject +
-#removingLifecycleEvent()]
+|xref:refguide:applib:index/annotation/DomainObject.adoc#removingLifecycleEvent[removingLifecycleEvent()]
 |entity is about to be deleted from the database using the xref:refguide:applib:index/services/repository/RepositoryService.adoc[RepositoryService]'s
 `#remove(...)` method.
 
 
 |xref:refguide:applib:index/events/lifecycle/ObjectUpdatedEvent.adoc[ObjectUpdatedEvent]
-|xref:refguide:applib:index/annotation/DomainObject.adoc#updatingLifecycleEvent[DomainObject +
-#updatingLifecycleEvent()]
+|xref:refguide:applib:index/annotation/DomainObject.adoc#updatingLifecycleEvent[updatingLifecycleEvent()]
 |entity has just been updated in the database.
 
 
 |xref:refguide:applib:index/events/lifecycle/ObjectUpdatingEvent.adoc[ObjectUpdatingEvent]
-|xref:refguide:applib:index/annotation/DomainObject.adoc#updatedLifecycleEvent[DomainObject +
-#updatedLifecycleEvent()]
+|xref:refguide:applib:index/annotation/DomainObject.adoc#updatedLifecycleEvent[updatedLifecycleEvent()]
 |entity is about to be updated in the database.
 
 
diff --git a/antora/components/refguide/modules/applib-classes/pages/events/uievent.adoc b/antora/components/refguide/modules/applib-classes/pages/events/uievent.adoc
index ac3033a..fdad34a 100644
--- a/antora/components/refguide/modules/applib-classes/pages/events/uievent.adoc
+++ b/antora/components/refguide/modules/applib-classes/pages/events/uievent.adoc
@@ -13,17 +13,17 @@ Note that if the domain object defines its own layout preferences (for example,
 
 
 .UI Event Classes
-[cols="2a,2a,2a,2a", options="header"]
+[cols="2m,2a,2a,2m", options="header"]
 |===
 
 |API
-|Event class defined by
-|Raised when
+|Event class defined by xref:refguide:applib:index/annotation/DomainObjectLayout.adoc[@DomainObjectLayout]
+|Published when
 |Overridden by
 
 
 |xref:refguide:applib:index/events/ui/TitleUiEvent.adoc[TitleUiEvent]
-|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#titleUiEvent[@DomainObjectLayout#titleUiEvent()]
+|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#titleUiEvent[titleUiEvent()]
 |\... rendering the title for a domain object.
 |xref:refguide:applib-methods:reserved.adoc#title[title()] +
 xref:refguide:applib:index/annotation/Title.adoc[@Title]
@@ -31,18 +31,18 @@ xref:refguide:applib:index/annotation/Title.adoc[@Title]
 
 
 |xref:refguide:applib:index/events/ui/IconUiEvent.adoc[IconUiEvent]
-|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#iconUiEvent[@DomainObjectLayout#iconUiEvent()]
+|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#iconUiEvent[iconUiEvent()]
 |\... rendering an icon for a domain object.
 |xref:refguide:applib-methods:reserved.adoc#iconName[iconName()]
 
 
 |xref:refguide:applib:index/events/ui/CssClassUiEvent.adoc[CssClassUiEvent]
-|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#cssClassUiEvent[@DomainObjectLayout#cssClassUiEvent()]
+|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#cssClassUiEvent[cssClassUiEvent()]
 |\... obtaining a CSS class hint for a domain object.
 |xref:refguide:applib-methods:reserved.adoc#cssClass[cssClass()]
 
 |xref:refguide:applib:index/events/ui/LayoutUiEvent.adoc[LayoutUiEvent]
-|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#layoutUiEvent[@DomainObjectLayout#layoutUiEvent()]
+|xref:refguide:applib:index/annotation/DomainObjectLayout.adoc#layoutUiEvent[layoutUiEvent()]
 |\... obtain an alternative layout for a domain object.
 |xref:refguide:applib-methods:reserved.adoc#layout[layout()]
 
diff --git a/antora/components/refguide/modules/applib-methods/pages/lifecycle.adoc b/antora/components/refguide/modules/applib-methods/pages/lifecycle.adoc
index dce1926..2bb786a 100644
--- a/antora/components/refguide/modules/applib-methods/pages/lifecycle.adoc
+++ b/antora/components/refguide/modules/applib-methods/pages/lifecycle.adoc
@@ -21,36 +21,33 @@ equivalent
 
 |created()
 |called when an object has just been created using xref:refguide:applib:index/services/factory/FactoryService.adoc[FactoryService#create(..)] or xref:refguide:applib:index/services/repository/RepositoryService.adoc[RepositoryService#detachedEntity(...)]
-|xref:applib-classes:events.adoc#ObjectCreatedEvent[ObjectCreatedEvent]
+|xref:refguide:applib:index/events/lifecycle/ObjectCreatedEvent.adoc[ObjectCreatedEvent]
 
 |loaded()
 |called when a (persistent) object has just been loaded from the object store.
-|xref:applib-classes:events.adoc#ObjectLoadedEvent[ObjectLoadedEvent]
+|xref:refguide:applib:index/events/lifecycle/ObjectLoadedEvent.adoc[ObjectLoadedEvent]
 
 |persisted()
 |called when object has just been persisted from the object store.
-|xref:applib-classes:events.adoc#ObjectPersistedEvent[ObjectPersistedEvent]
+|xref:refguide:applib:index/events/lifecycle/ObjectPersistedEvent.adoc[ObjectPersistedEvent]
 
 |persisting()
 |called when a (not-yet-persistent) object is just about to be persisted from the object store
-|xref:applib-classes:events.adoc#ObjectPersistingEvent[ObjectPersistingEvent]
+|xref:refguide:applib:index/events/lifecycle/ObjectPersistingEvent.adoc[ObjectPersistingEvent]
 
 |removing()
 |called when a (persistent) object is just about to be deleted from the object store
-|xref:applib-classes:events.adoc#ObjectRemovingEvent[ObjectRemovingEvent]
+|xref:refguide:applib:index/events/lifecycle/ObjectRemovingEvent.adoc[ObjectRemovingEvent]
 
 |updated()
 |called when a (persistent) object has just been updated in the object store
-|xref:applib-classes:events.adoc#ObjectUpdatedEvent[ObjectUpdatedEvent]
+|xref:refguide:applib:index/events/lifecycle/ObjectUpdatedEvent.adoc[ObjectUpdatedEvent]
 
 |updating()
 |called when a (persistent) object is just about to be updated in the object store
-|xref:applib-classes:events.adoc#ObjectUpdatingEvent[ObjectUpdatingEvent]
+|xref:refguide:applib:index/events/lifecycle/ObjectUpdatingEvent.adoc[ObjectUpdatingEvent]
 
 |===
 
-[TIP]
-====
-A more flexible/decoupled design is to implement a subscriber to the equivalent xref:applib-classes:about.adoc#lifecycle-events[lifecycle event]s.
-====
+Further discussion on using events and a subscriber (which will result in a more flexible/decoupled design) can be found xref:applib-classes:events.adoc#lifecycle-events[here].
 
diff --git a/antora/components/refguide/modules/applib-methods/pages/prefixes.adoc b/antora/components/refguide/modules/applib-methods/pages/prefixes.adoc
index 6291018..926e4ff 100644
--- a/antora/components/refguide/modules/applib-methods/pages/prefixes.adoc
+++ b/antora/components/refguide/modules/applib-methods/pages/prefixes.adoc
@@ -14,7 +14,7 @@ Supporting methods are, therefore, each characterized by their own particular pr
 The table below lists the method prefixes that are recognized as part of Apache Isis' default programming model.
 
 .Recognized Method Prefixes
-[cols="2,1,1,1,1,1,4a",options="header"]
+[cols="2m,1,1,1,1,1,4a",options="header"]
 |===
 
 |Prefix
@@ -26,18 +26,6 @@ The table below lists the method prefixes that are recognized as part of Apache
 Param
 |Description
 
-//|xref:refguide:applib-methods:prefixes.adoc#addTo[addTo...()]
-//|
-//|
-//|Y
-//|
-//|
-//|add object to a collection  +
-//
-//NOTE: Directly mutable collections are not currently supported by the xref:vw:ROOT:about.adoc[Wicket viewer].
-//
-//See also xref:refguide:applib-methods:prefixes.adoc#removeFrom[removeFrom...()]`
-
 
 |xref:refguide:applib-methods:prefixes.adoc#autoComplete[autoComplete...()]
 |
diff --git a/antora/components/refguide/modules/applib-methods/pages/reserved.adoc b/antora/components/refguide/modules/applib-methods/pages/reserved.adoc
index 58d430c..35d0fa8 100644
--- a/antora/components/refguide/modules/applib-methods/pages/reserved.adoc
+++ b/antora/components/refguide/modules/applib-methods/pages/reserved.adoc
@@ -7,7 +7,7 @@
 The table below lists the reserved methods that are recognized as part of Apache Isis' default programming model.
 
 .Reserved Methods
-[cols="1,4a", options="header"]
+[cols="1m,4a", options="header"]
 |===
 
 |Method
@@ -17,17 +17,6 @@ The table below lists the reserved methods that are recognized as part of Apache
 |Provides a CSS class for this object instance.
 In conjunction with `static/css/application-css`, can therefore provide custom styling of an object instance wherever it is rendered.
 
-//|xref:refguide:applib-methods:reserved.adoc#disable[disable(...)]
-//|Disable all or some of an object's properties
-
-//|xref:refguide:applib-methods:reserved.adoc#getId[getId()]
-//|Provides an optional unique identifier of a service.
-//
-//If not provided, the service's fully-qualified class name is used.
-
-//|xref:refguide:applib-methods:reserved.adoc#hide[hide(...)]
-//|Hide all or some of an object's properties
-
 |xref:refguide:applib-methods:reserved.adoc#iconName[iconName()]
 |Provides the name of the image to render, usually alongside the title, to represent the object.
 If not provided, then the class name is used to locate an image.
@@ -39,19 +28,12 @@ If null or no such layout, then uses to the default layout.
 |xref:refguide:applib-methods:reserved.adoc#title[title()]
 |Provides a title for the object. +
 
-//|xref:refguide:applib-methods:reserved.adoc#validate[validate()]
-//|Validate the object's state prior to persisting.
-
 |===
 
 
 
 
 include::reserved/cssClass.adoc[leveloffset=+1]
-//include::reserved/disable.adoc[leveloffset=+1]
-//include::reserved/getId.adoc[leveloffset=+1]
-//include::reserved/hide.adoc[leveloffset=+1]
 include::reserved/iconName.adoc[leveloffset=+1]
 include::reserved/layout.adoc[leveloffset=+1]
 include::reserved/title.adoc[leveloffset=+1]
-//include::reserved/validate.adoc[leveloffset=+1]
diff --git a/antora/components/refguide/modules/applib-methods/pages/reserved/cssClass.adoc b/antora/components/refguide/modules/applib-methods/pages/reserved/cssClass.adoc
index 2aef561..b14fd6a 100644
--- a/antora/components/refguide/modules/applib-methods/pages/reserved/cssClass.adoc
+++ b/antora/components/refguide/modules/applib-methods/pages/reserved/cssClass.adoc
@@ -41,10 +41,3 @@ tr.done {
 }
 ----
 
-== See also
-
-See also:
-
-* xref:refguide:applib-methods:reserved.adoc#title[title()]
-* xref:refguide:applib-methods:reserved.adoc#iconName[iconName()]
-* xref:refguide:applib-methods:reserved.adoc#layout[layout()]
diff --git a/antora/components/refguide/modules/applib-methods/pages/reserved/iconName.adoc b/antora/components/refguide/modules/applib-methods/pages/reserved/iconName.adoc
index 289528b..90001ba 100644
--- a/antora/components/refguide/modules/applib-methods/pages/reserved/iconName.adoc
+++ b/antora/components/refguide/modules/applib-methods/pages/reserved/iconName.adoc
@@ -37,11 +37,3 @@ public class ToDoItem ... {
 }
 ----
 
-== See also
-
-See also:
-
-* xref:refguide:applib-methods:reserved.adoc#title[title()]
-* xref:refguide:applib-methods:reserved.adoc#iconName[iconName()]
-* xref:refguide:applib-methods:reserved.adoc#cssClass[cssClass()]
-* xref:refguide:applib-methods:reserved.adoc#layout[layout()]
diff --git a/antora/components/refguide/modules/applib-methods/pages/reserved/layout.adoc b/antora/components/refguide/modules/applib-methods/pages/reserved/layout.adoc
index d0b3e5e..8a89462 100644
--- a/antora/components/refguide/modules/applib-methods/pages/reserved/layout.adoc
+++ b/antora/components/refguide/modules/applib-methods/pages/reserved/layout.adoc
@@ -5,7 +5,7 @@
 
 
 Every object has a xref:userguide:fun:ui.adoc#object-layout[layout] .
-This may be specified using annotations such as xref:refguide:applib:index/annotation/MemberOrder.adoc[@MemberOrder], xref:refguide:applib:index/annotation/DomainObjectLayout.adoc[@DomainObjectLayout] and the like,  but it much more commonly specified using an xref:userguide:fun:ui.adoc#object-layout [XML layout file].
+This may be specified using annotations such as xref:refguide:applib:index/annotation/MemberOrder.adoc[@MemberOrder], xref:refguide:applib:index/annotation/DomainObjectLayout.adoc[@DomainObjectLayout] and the like, but it much more commonly specified using an xref:userguide:fun:ui.adoc#object-layout [XML layout file].
 
 The `layout` method allows the domain object to specify an alternate layout to its usual layout.
 
@@ -38,10 +38,3 @@ public class Customer {
 If `switchToEditMode()` action is invoked, then the UI will attempt to render the customer using a `Customer.layout.edit.xml` layout file (instead of the default `Customer.layout.xml`).
 
 
-== See also
-
-See also:
-
-* xref:refguide:applib-methods:reserved.adoc#title[title()]
-* xref:refguide:applib-methods:reserved.adoc#iconName[iconName()]
-* xref:refguide:applib-methods:reserved.adoc#cssClass[cssClass()]
diff --git a/antora/components/refguide/modules/applib-methods/pages/reserved/title.adoc b/antora/components/refguide/modules/applib-methods/pages/reserved/title.adoc
index b8587ab..2c2b9a9 100644
--- a/antora/components/refguide/modules/applib-methods/pages/reserved/title.adoc
+++ b/antora/components/refguide/modules/applib-methods/pages/reserved/title.adoc
@@ -48,13 +48,3 @@ As the example above shows, the implementation can be as complex as you like.
 
 In many cases, though, you may be able to use the xref:refguide:applib:index/annotation/Title.adoc[@Title] annotation.
 
-r
-
-== See also
-
-See also:
-
-* xref:refguide:applib-methods:reserved.adoc#iconName[iconName()]
-* xref:refguide:applib-methods:reserved.adoc#cssClass[cssClass()]
-* xref:refguide:applib-methods:reserved.adoc#layout[layout()]
-
diff --git a/antora/components/relnotes/modules/ROOT/pages/2020/2.0.0-M5/mignotes.adoc b/antora/components/relnotes/modules/ROOT/pages/2020/2.0.0-M5/mignotes.adoc
index 1955925..babca23 100644
--- a/antora/components/relnotes/modules/ROOT/pages/2020/2.0.0-M5/mignotes.adoc
+++ b/antora/components/relnotes/modules/ROOT/pages/2020/2.0.0-M5/mignotes.adoc
@@ -105,7 +105,7 @@ javax.jdo. ...
 |===
 
 Framework functionality was removed to inspect the JDO meta-model for any schemas, such that these would be auto-created. This responsibility is now delegated to Spring.
-However, as a fallback we introduced configuration options, that allow explicit schema creation by the framework, for both JDO and JPA: 
+However, as a fallback we introduced configuration options, that allow explicit schema creation by the framework, for both JDO and JPA:
 
 [source,yaml]
 .application.yml
@@ -386,12 +386,19 @@ Permission are now matched against logical packages, logical object types or log
 SecMan database schema changed, namely the *ApplicationPermission* table! See table below.
 ====
 
-[Source,sql]
+[source,sql]
 .SecMan database migration // adapt to your schema and db vendor!
 ----
-UPDATE ApplicationPermission SET featureType='NAMESPACE' WHERE featureType like 'PACKAGE';
-UPDATE ApplicationPermission SET featureType='TYPE' WHERE featureType like 'CLASS';
-ALTER TABLE ApplicationPermission RENAME COLUMN `featureType` TO `featureSort`;
+UPDATE ApplicationPermission
+   SET featureType='NAMESPACE'
+ WHERE featureType like 'PACKAGE';
+
+UPDATE ApplicationPermission
+   SET featureType='TYPE'
+ WHERE featureType like 'CLASS';
+
+ALTER TABLE ApplicationPermission
+    RENAME COLUMN `featureType` TO `featureSort`;
 ----
 
 [cols="3m,3m,3a", options="header"]
diff --git a/core/adoc/modules/ROOT/partials/component-nav.adoc b/core/adoc/modules/ROOT/partials/component-nav.adoc
index 9edf781..54e631a 100644
--- a/core/adoc/modules/ROOT/partials/component-nav.adoc
+++ b/core/adoc/modules/ROOT/partials/component-nav.adoc
@@ -4,7 +4,6 @@ include::core:commons:partial$module-nav.adoc[]
 include::core:codegen-bytebuddy:partial$module-nav.adoc[]
 include::core:metamodel:partial$module-nav.adoc[]
 include::core:runtime:partial$module-nav.adoc[]
-include::core:runtime-services:partial$module-nav.adoc[]
 include::core:webapp:partial$module-nav.adoc[]
 include::core:regressiontests:partial$module-nav.adoc[]
 
diff --git a/core/config/src/main/adoc/modules/config/pages/section-hooks/isis.persistence.schema~post.adoc b/core/config/src/main/adoc/modules/config/pages/section-hooks/isis.persistence.schema~post.adoc
new file mode 100644
index 0000000..9e0d1b7
--- /dev/null
+++ b/core/config/src/main/adoc/modules/config/pages/section-hooks/isis.persistence.schema~post.adoc
@@ -0,0 +1,3 @@
+
+: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/core/config/src/main/adoc/modules/config/pages/section-hooks/isis.persistence.schema~pre.adoc b/core/config/src/main/adoc/modules/config/pages/section-hooks/isis.persistence.schema~pre.adoc
new file mode 100644
index 0000000..ce0c7df
--- /dev/null
+++ b/core/config/src/main/adoc/modules/config/pages/section-hooks/isis.persistence.schema~pre.adoc
@@ -0,0 +1,4 @@
+
+: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 [...]
+
+Configuration that applies to database persistence schema (used by JPA and JDO datastores).