You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by ah...@apache.org on 2022/01/31 13:59:01 UTC

[isis] branch master updated: ISIS-2952: docs: re-create site index

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

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


The following commit(s) were added to refs/heads/master by this push:
     new 4d0d4ce  ISIS-2952: docs: re-create site index
4d0d4ce is described below

commit 4d0d4ce054d7902ccabf60ddcca7a3218734870a
Author: Andi Huber <ah...@apache.org>
AuthorDate: Mon Jan 31 14:58:52 2022 +0100

    ISIS-2952: docs: re-create site index
---
 .../pages/index/services/user/UserMemento.adoc     | 10 +++
 .../pages/index/services/user/UserService.adoc     | 11 ++++
 .../pages/index/util/schema/CommonDtoUtils.adoc    |  4 ++
 .../services/schema/SchemaValueMarshaller.adoc     | 64 +++++++++----------
 .../applib/annotation/InteractAs.adoc              | 72 ++++++++++++++++++++++
 core/adoc/modules/_overview/pages/about.adoc       | 14 +++--
 .../applib/annotation/InteractAs.java              |  2 +
 7 files changed, 140 insertions(+), 37 deletions(-)

diff --git a/antora/components/refguide-index/modules/applib/pages/index/services/user/UserMemento.adoc b/antora/components/refguide-index/modules/applib/pages/index/services/user/UserMemento.adoc
index 1cfe757..12db1ab 100644
--- a/antora/components/refguide-index/modules/applib/pages/index/services/user/UserMemento.adoc
+++ b/antora/components/refguide-index/modules/applib/pages/index/services/user/UserMemento.adoc
@@ -22,6 +22,7 @@ class UserMemento {
   boolean isCurrentUser(String userName)     // <.>
   Stream<String> streamRoleNames()
   boolean hasRoleName(String roleName)
+  boolean isSystem()     // <.>
   UserMementoBuilder asBuilder()
   UserLocale asUserLocale()
 }
@@ -72,6 +73,11 @@ The roles associated with this user.
 --
 Determine if the specified name is this user.
 --
+<.> xref:#isSystem__[isSystem()]
++
+--
+Whether this xref:refguide:applib:index/services/user/UserMemento.adoc[UserMemento] represent the _system user_ .
+--
 
 == Members
 
@@ -120,3 +126,7 @@ The roles associated with this user.
 
 Determine if the specified name is this user.
 
+[#isSystem__]
+=== isSystem()
+
+Whether this xref:refguide:applib:index/services/user/UserMemento.adoc[UserMemento] represent the _system user_ .
diff --git a/antora/components/refguide-index/modules/applib/pages/index/services/user/UserService.adoc b/antora/components/refguide-index/modules/applib/pages/index/services/user/UserService.adoc
index 49123f2..4414ee1 100644
--- a/antora/components/refguide-index/modules/applib/pages/index/services/user/UserService.adoc
+++ b/antora/components/refguide-index/modules/applib/pages/index/services/user/UserService.adoc
@@ -15,6 +15,7 @@ In addition, if impersonation has been invoked through the xref:refguide:applib:
 class UserService {
   public static final String NOBODY;     // <.>
   Optional<UserMemento> currentUser()     // <.>
+  boolean isCurrentUserWithSystemPrivileges()     // <.>
   UserMemento getUser()     // <.>
   UserMemento currentUserElseFail()     // <.>
   Optional<String> currentUserName()     // <.>
@@ -36,6 +37,11 @@ Default returned from _#currentUserNameElseNobody()_ .
 --
 Returns the details about the current user, either the "effective" user (if being _#impersonateUser(String, List, String) impersonated_ ) otherwise the "real" user (as obtained from the xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] of the current thread).
 --
+<.> xref:#isCurrentUserWithSystemPrivileges__[isCurrentUserWithSystemPrivileges()]
++
+--
+Whether the current user is the _system user_ (as obtained from the xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] of the current thread).
+--
 <.> xref:#getUser__[getUser()]
 +
 --
@@ -89,6 +95,11 @@ Default returned from _#currentUserNameElseNobody()_ .
 
 Returns the details about the current user, either the "effective" user (if being _#impersonateUser(String, List, String) impersonated_ ) otherwise the "real" user (as obtained from the xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] of the current thread).
 
+[#isCurrentUserWithSystemPrivileges__]
+=== isCurrentUserWithSystemPrivileges()
+
+Whether the current user is the _system user_ (as obtained from the xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] of the current thread).
+
 [#getUser__]
 === getUser()
 
diff --git a/antora/components/refguide-index/modules/applib/pages/index/util/schema/CommonDtoUtils.adoc b/antora/components/refguide-index/modules/applib/pages/index/util/schema/CommonDtoUtils.adoc
index 7e53ad2..9d35f89 100644
--- a/antora/components/refguide-index/modules/applib/pages/index/util/schema/CommonDtoUtils.adoc
+++ b/antora/components/refguide-index/modules/applib/pages/index/util/schema/CommonDtoUtils.adoc
@@ -7,6 +7,10 @@
 .CommonDtoUtils.java
 ----
 class CommonDtoUtils {
+  D recordFundamentalValue(ValueType valueType, D valueDto, Object pojo)
+  Object getValueAsObject(ValueWithTypeDto valueDto)
+  Object getValueAsObject(ValueType valueType, ValueDto valueDto)
+  ValueWithTypeDto toValueWithTypeDto(ValueType valueType, ValueDto valueDto)
   String getMapValue(MapDto mapDto, String key)
   void putMapKeyValue(MapDto mapDto, String key, String value)
 }
diff --git a/antora/components/refguide-index/modules/core/pages/index/metamodel/services/schema/SchemaValueMarshaller.adoc b/antora/components/refguide-index/modules/core/pages/index/metamodel/services/schema/SchemaValueMarshaller.adoc
index 18b3023..14156f3 100644
--- a/antora/components/refguide-index/modules/core/pages/index/metamodel/services/schema/SchemaValueMarshaller.adoc
+++ b/antora/components/refguide-index/modules/core/pages/index/metamodel/services/schema/SchemaValueMarshaller.adoc
@@ -13,13 +13,13 @@ interface SchemaValueMarshaller {
   Identifier actionIdentifier(ActionDto actionDto)     // <.>
   Identifier propertyIdentifier(PropertyDto propertyDto)     // <.>
   ManagedObject recoverReferenceFrom(OidDto oidDto)
-  ManagedObject recoverValueFrom(PropertyDto propertyDto)     // <.>
-  ManagedObject recoverValuesFrom(Identifier paramIdentifier, ParamDto paramDto)     // <.>
-  ActionInvocationDto recordActionResultScalar(ActionInvocationDto invocationDto, ObjectSpecification elementType, ManagedObject value)     // <.>
-  ActionInvocationDto recordActionResultNonScalar(ActionInvocationDto invocationDto, ObjectSpecification elementType, Can<ManagedObject> values)     // <.>
-  PropertyDto recordPropertyValue(PropertyDto propertyDto, ObjectSpecification elementType, ManagedObject value)     // <.>
-  ParamDto recordParamScalar(Identifier paramIdentifier, ParamDto paramDto, ObjectSpecification elementType, ManagedObject value)     // <.>
-  ParamDto recordParamNonScalar(Identifier paramIdentifier, ParamDto paramDto, ObjectSpecification elementType, Can<ManagedObject> values)     // <.>
+  ManagedObject recoverPropertyFrom(PropertyDto propertyDto)     // <.>
+  ManagedObject recoverParameterFrom(Identifier paramIdentifier, ParamDto paramDto)     // <.>
+  ActionInvocationDto recordActionResultScalar(ActionInvocationDto invocationDto, ObjectAction objectAction, ManagedObject value)     // <.>
+  ActionInvocationDto recordActionResultNonScalar(ActionInvocationDto invocationDto, ObjectAction objectAction, Can<ManagedObject> values)     // <.>
+  PropertyDto recordPropertyValue(PropertyDto propertyDto, OneToOneAssociation property, ManagedObject value)     // <.>
+  ParamDto recordParamScalar(ParamDto paramDto, ObjectActionParameter param, ManagedObject value)     // <.>
+  ParamDto recordParamNonScalar(ParamDto paramDto, ObjectActionParameter param, Can<ManagedObject> values)     // <.>
 }
 ----
 
@@ -38,37 +38,37 @@ Recovers an _Action's_ xref:refguide:applib:index/Identifier.adoc[Identifier] fr
 --
 Recovers a _Property's_ xref:refguide:applib:index/Identifier.adoc[Identifier] from given DTO.
 --
-<.> xref:#recoverValueFrom__PropertyDto[recoverValueFrom(PropertyDto)]
+<.> xref:#recoverPropertyFrom__PropertyDto[recoverPropertyFrom(PropertyDto)]
 +
 --
-Recovers a property value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Property_ .
+Recovers a property value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Property_ . Cardinality _0..1_
 --
-<.> xref:#recoverValuesFrom__Identifier_ParamDto[recoverValuesFrom(Identifier, ParamDto)]
+<.> xref:#recoverParameterFrom__Identifier_ParamDto[recoverParameterFrom(Identifier, ParamDto)]
 +
 --
-Recovers a parameter value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ .
+Recovers a parameter value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ . Cardinality _0..n_
 --
-<.> xref:#recordActionResultScalar__ActionInvocationDto_ObjectSpecification_ManagedObject[recordActionResultScalar(ActionInvocationDto, ObjectSpecification, ManagedObject)]
+<.> xref:#recordActionResultScalar__ActionInvocationDto_ObjectAction_ManagedObject[recordActionResultScalar(ActionInvocationDto, ObjectAction, ManagedObject)]
 +
 --
 Records given result value into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action_ .
 --
-<.> xref:#recordActionResultNonScalar__ActionInvocationDto_ObjectSpecification_Can[recordActionResultNonScalar(ActionInvocationDto, ObjectSpecification, Can)]
+<.> xref:#recordActionResultNonScalar__ActionInvocationDto_ObjectAction_Can[recordActionResultNonScalar(ActionInvocationDto, ObjectAction, Can)]
 +
 --
 Records given result values into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action_ .
 --
-<.> xref:#recordPropertyValue__PropertyDto_ObjectSpecification_ManagedObject[recordPropertyValue(PropertyDto, ObjectSpecification, ManagedObject)]
+<.> xref:#recordPropertyValue__PropertyDto_OneToOneAssociation_ManagedObject[recordPropertyValue(PropertyDto, OneToOneAssociation, ManagedObject)]
 +
 --
 Records given property value into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Property_ .
 --
-<.> xref:#recordParamScalar__Identifier_ParamDto_ObjectSpecification_ManagedObject[recordParamScalar(Identifier, ParamDto, ObjectSpecification, ManagedObject)]
+<.> xref:#recordParamScalar__ParamDto_ObjectActionParameter_ManagedObject[recordParamScalar(ParamDto, ObjectActionParameter, ManagedObject)]
 +
 --
 Records given parameter value into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ .
 --
-<.> xref:#recordParamNonScalar__Identifier_ParamDto_ObjectSpecification_Can[recordParamNonScalar(Identifier, ParamDto, ObjectSpecification, Can)]
+<.> xref:#recordParamNonScalar__ParamDto_ObjectActionParameter_Can[recordParamNonScalar(ParamDto, ObjectActionParameter, Can)]
 +
 --
 Records given parameter values into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ .
@@ -91,39 +91,39 @@ Recovers an _Action's_ xref:refguide:applib:index/Identifier.adoc[Identifier] fr
 
 Recovers a _Property's_ xref:refguide:applib:index/Identifier.adoc[Identifier] from given DTO.
 
-[#recoverValueFrom__PropertyDto]
-=== recoverValueFrom(PropertyDto)
+[#recoverPropertyFrom__PropertyDto]
+=== recoverPropertyFrom(PropertyDto)
 
-Recovers a property value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Property_ .
+Recovers a property value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Property_ . Cardinality _0..1_
 
-[#recoverValuesFrom__Identifier_ParamDto]
-=== recoverValuesFrom(Identifier, ParamDto)
+[#recoverParameterFrom__Identifier_ParamDto]
+=== recoverParameterFrom(Identifier, ParamDto)
 
-Recovers a parameter value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ .
+Recovers a parameter value, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ . Cardinality _0..n_
 
 Packed up if non-scalar.
 
-[#recordActionResultScalar__ActionInvocationDto_ObjectSpecification_ManagedObject]
-=== recordActionResultScalar(ActionInvocationDto, ObjectSpecification, ManagedObject)
+[#recordActionResultScalar__ActionInvocationDto_ObjectAction_ManagedObject]
+=== recordActionResultScalar(ActionInvocationDto, ObjectAction, ManagedObject)
 
 Records given result value into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action_ .
 
-[#recordActionResultNonScalar__ActionInvocationDto_ObjectSpecification_Can]
-=== recordActionResultNonScalar(ActionInvocationDto, ObjectSpecification, Can)
+[#recordActionResultNonScalar__ActionInvocationDto_ObjectAction_Can]
+=== recordActionResultNonScalar(ActionInvocationDto, ObjectAction, Can)
 
 Records given result values into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action_ .
 
-[#recordPropertyValue__PropertyDto_ObjectSpecification_ManagedObject]
-=== recordPropertyValue(PropertyDto, ObjectSpecification, ManagedObject)
+[#recordPropertyValue__PropertyDto_OneToOneAssociation_ManagedObject]
+=== recordPropertyValue(PropertyDto, OneToOneAssociation, ManagedObject)
 
 Records given property value into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Property_ .
 
-[#recordParamScalar__Identifier_ParamDto_ObjectSpecification_ManagedObject]
-=== recordParamScalar(Identifier, ParamDto, ObjectSpecification, ManagedObject)
+[#recordParamScalar__ParamDto_ObjectActionParameter_ManagedObject]
+=== recordParamScalar(ParamDto, ObjectActionParameter, ManagedObject)
 
 Records given parameter value into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ .
 
-[#recordParamNonScalar__Identifier_ParamDto_ObjectSpecification_Can]
-=== recordParamNonScalar(Identifier, ParamDto, ObjectSpecification, Can)
+[#recordParamNonScalar__ParamDto_ObjectActionParameter_Can]
+=== recordParamNonScalar(ParamDto, ObjectActionParameter, Can)
 
 Records given parameter values into given DTO object, using xref:refguide:applib:index/value/semantics/ValueSemanticsProvider.adoc[ValueSemanticsProvider] for corresponding _Action Parameter_ .
diff --git a/antora/components/refguide-index/modules/testing/pages/index/integtestsupport/applib/annotation/InteractAs.adoc b/antora/components/refguide-index/modules/testing/pages/index/integtestsupport/applib/annotation/InteractAs.adoc
new file mode 100644
index 0000000..e8d0154
--- /dev/null
+++ b/antora/components/refguide-index/modules/testing/pages/index/integtestsupport/applib/annotation/InteractAs.adoc
@@ -0,0 +1,72 @@
+= @InteractAs
+: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 [...]
+
+Offers an alternative to xref:refguide:applib:index/services/iactnlayer/InteractionService.adoc[InteractionService] 's imperative approach to switch the xref:refguide:applib:index/services/iactnlayer/InteractionContext.adoc[InteractionContext] for a given block of _JUnit_ test code.
+
+Example:
+
+----
+
+@Test
+@InteractAs(
+    userName = "sven",
+    localeName = "en",
+    frozenDateTime = "2010-01-01 13:02:04 -03")
+void test() {
+    // ...
+}
+----
+
+== API
+
+[source,java]
+.InteractAs.java
+----
+@interface InteractAs {
+  String userName() default // unspecified
+"";     // <.>
+  String localeName() default // unspecified
+"";     // <.>
+  String frozenDateTime() default // unspecified
+"";     // <.>
+}
+----
+
+<.> xref:#userName[userName]
++
+--
+If empty, defaults to the system user (with elevated privileges).
+--
+<.> xref:#localeName[localeName]
++
+--
+The _Locale_ language tag. Eg. "en", "fr", "de", ... If empty, defaults to current system locale.
+--
+<.> xref:#frozenDateTime[frozenDateTime]
++
+--
+If empty, defaults to current system time.
+--
+
+== Members
+
+[#userName]
+=== userName
+
+If empty, defaults to the system user (with elevated privileges).
+
+[#localeName]
+=== localeName
+
+The _Locale_ language tag. Eg. "en", "fr", "de", ... If empty, defaults to current system locale.
+
+[#frozenDateTime]
+=== frozenDateTime
+
+If empty, defaults to current system time.
+
+Format: _"yyyy-MM-dd HH:mm:ss[.SSS][' '][XXX][x]"_Examples:
+
+* "2022-01-31 14:04:33.017 -03:30" (full form)
+* "2022-01-31 14:04:33 -03" (no millis, no offset minutes)
+* "2022-01-31 14:04:33 Z" (no millis, no offset = UTC)
diff --git a/core/adoc/modules/_overview/pages/about.adoc b/core/adoc/modules/_overview/pages/about.adoc
index cc6ef74..67c648c 100644
--- a/core/adoc/modules/_overview/pages/about.adoc
+++ b/core/adoc/modules/_overview/pages/about.adoc
@@ -589,7 +589,7 @@ org.springframework.boot:spring-boot-starter-test:jar:<managed> +
 
 .Document Index Entries
 ****
-xref:refguide:testing:index/integtestsupport/applib/ExceptionRecognizerTranslate.adoc[ExceptionRecognizerTranslate], xref:refguide:testing:index/integtestsupport/applib/IsisIntegrationTestAbstract.adoc[IsisIntegrationTestAbstract], xref:refguide:testing:index/integtestsupport/applib/IsisInteractionHandler.adoc[IsisInteractionHandler], xref:refguide:testing:index/integtestsupport/applib/IsisModuleTestingIntegTestSupportApplib.adoc[IsisModuleTestingIntegTestSupportApplib], xref:refguide:te [...]
+xref:refguide:testing:index/integtestsupport/applib/ExceptionRecognizerTranslate.adoc[ExceptionRecognizerTranslate], xref:refguide:testing:index/integtestsupport/applib/IsisIntegrationTestAbstract.adoc[IsisIntegrationTestAbstract], xref:refguide:testing:index/integtestsupport/applib/IsisInteractionHandler.adoc[IsisInteractionHandler], xref:refguide:testing:index/integtestsupport/applib/IsisModuleTestingIntegTestSupportApplib.adoc[IsisModuleTestingIntegTestSupportApplib], xref:refguide:te [...]
 ****
 
 |Apache Isis Tst - Spec/Cucumber (parent)
@@ -764,6 +764,7 @@ org.apache.isis.extensions:isis-extensions-secman-integration:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-persistence-jdo:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-persistence-jpa:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-shiro-realm:jar:<managed> +
+org.apache.isis.incubator.clients:isis-client-kroviz:jar:2.0.0-SNAPSHOT +
 org.apache.isis.valuetypes:isis-valuetypes-asciidoc-metamodel:jar:<managed> +
 org.apache.isis.valuetypes:isis-valuetypes-asciidoc-persistence-jdo:jar:<managed> +
 org.apache.isis.valuetypes:isis-valuetypes-asciidoc-persistence-jpa:jar:<managed> +
@@ -1028,6 +1029,7 @@ org.apache.isis.extensions:isis-extensions-secman-integration:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-persistence-jdo:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-persistence-jpa:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-shiro-realm:jar:<managed> +
+org.apache.isis.incubator.clients:isis-client-kroviz:jar:${project.version} +
 org.apache.isis.testing:isis-testing-h2console-ui:jar:<managed> +
 org.apache.isis.testing:isis-testing-unittestsupport-applib:jar:<managed> +
 org.apache.isis.valuetypes:isis-valuetypes-markdown-applib:jar:<managed> +
@@ -1652,6 +1654,7 @@ o.a.i.core.metamodel.services.tablecol.TableColumnOrderServiceUsingTxtFile +
 o.a.i.core.metamodel.services.title.TitleServiceDefault +
 o.a.i.core.metamodel.specloader.ProgrammingModelServiceDefault +
 o.a.i.core.metamodel.specloader.SpecificationLoaderDefault +
+o.a.i.core.metamodel.valuesemantics.ApplicationFeatureIdValueSemantics +
 o.a.i.core.metamodel.valuesemantics.BigDecimalValueSemantics +
 o.a.i.core.metamodel.valuesemantics.BigIntegerValueSemantics +
 o.a.i.core.metamodel.valuesemantics.BlobValueSemantics +
@@ -5921,7 +5924,7 @@ eg. code mining, automated documentation.
 
 .Dependencies
 ****
-org.checkerframework:checker-qual:jar:3.21.0 +
+org.checkerframework:checker-qual:jar:3.21.1 +
 org.junit.jupiter:junit-jupiter-api:jar:<managed> +
 org.junit.jupiter:junit-jupiter-engine:jar:<managed> +
 org.junit.vintage:junit-vintage-engine:jar:<managed> +
@@ -6261,6 +6264,7 @@ o.a.i.testdomain.util.rest.RestEndpointService +
 
 .Dependencies
 ****
+org.apache.isis.extensions:isis-extensions-fullcalendar-applib:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-encryption-jbcrypt:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-integration:jar:<managed> +
 org.apache.isis.extensions:isis-extensions-secman-persistence-jdo:jar:<managed> +
@@ -6562,7 +6566,7 @@ skinparam rectangle<<2>> {
   BorderColor #2E6295
 }
 package "Kroviz Client\n[Software System]" {
-  rectangle "==Apache Isis Inc - Client kroViz\n<size:10>[Container: packaging: jar]</size>" <<2>> as 2
+  rectangle "==Apache Isis Incubator - Client kroViz\n<size:10>[Container: packaging: jar]</size>" <<2>> as 2
 }
 @enduml
 ----
@@ -6571,7 +6575,7 @@ package "Kroviz Client\n[Software System]" {
 |===
 |Coordinates |Description 
 
-|Apache Isis Inc - Client kroViz
+|Apache Isis Incubator - Client kroViz
 [source,yaml]
 ----
 Group: org.apache.isis.incubator.clients
@@ -6579,7 +6583,7 @@ Artifact: isis-client-kroviz
 Type: jar
 Directory: /incubator/clients/kroviz
 ----
-|Initial sketches
+|Web client based on RESTful API
 |===
 
 === JavaFX Viewer
diff --git a/testing/integtestsupport/applib/src/main/java/org/apache/isis/testing/integtestsupport/applib/annotation/InteractAs.java b/testing/integtestsupport/applib/src/main/java/org/apache/isis/testing/integtestsupport/applib/annotation/InteractAs.java
index 0ff9412..65ea8ff 100644
--- a/testing/integtestsupport/applib/src/main/java/org/apache/isis/testing/integtestsupport/applib/annotation/InteractAs.java
+++ b/testing/integtestsupport/applib/src/main/java/org/apache/isis/testing/integtestsupport/applib/annotation/InteractAs.java
@@ -43,6 +43,8 @@ import org.apache.isis.applib.services.iactnlayer.InteractionService;
  *     // ...
  * }
  * </pre>
+ *
+ * @since 2.0 {@index}
  */
 @Inherited
 @Target({ ElementType.METHOD, ElementType.ANNOTATION_TYPE })