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 2023/01/03 08:38:20 UTC

[isis] branch ISIS-3255 updated (60c1255876 -> 39215d3440)

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

danhaywood pushed a change to branch ISIS-3255
in repository https://gitbox.apache.org/repos/asf/isis.git


 discard 60c1255876 ISIS-3255: updates index.html with warning re: Windows classpath length limits
     add a1e9fbcbce Bump cucumber.version from 7.9.0 to 7.10.0
     add 509aa76b2b Merge pull request #1254 from apache/dependabot/maven/master/cucumber.version-7.10.0
     add cdb5e69e25 Bump dependency-check-maven from 7.4.0 to 7.4.1
     add 2b5814f50a Merge pull request #1253 from apache/dependabot/maven/master/org.owasp-dependency-check-maven-7.4.1
     add 59b86976b6 ISIS-3301: collection presentation selection done with a simple btn-link
     add 9055c3e0d4 ISIS-3294: properly creates bookmark for ApplicationFeatureViewModel (fixes NPE)
     add a09f71a7cf ISIS-3306: Schema: generate '@Named' annotations
     add 8bfec7a1b3 ISIS-3306: Schema gen.: fixes 'Serializable' not being processed
     add 6c1ac7e744 ISIS-3306: backport schema gen. conf. simplification from spring6 branch
     add 139d0ca51c Bump javaparser-core from 3.24.8 to 3.24.9
     add 7ffb65a873 Merge pull request #1257 from apache/dependabot/maven/master/com.github.javaparser-javaparser-core-3.24.9
     add e3a04ae639 Bump slf4j-api from 2.0.5 to 2.0.6
     add d0943b2050 Merge pull request #1259 from apache/dependabot/maven/master/org.slf4j-slf4j-api-2.0.6
     add eb5d8faee8 Bump cxf-rt-rs-client from 3.5.4 to 3.5.5
     add 10e5aceb92 Merge pull request #1258 from apache/dependabot/maven/master/org.apache.cxf-cxf-rt-rs-client-3.5.5
     add df0f7e23bb ISIS-3304: promote Json utils from internal to public
     add fe5aadbe69 ISIS-3304: JsonUtils polishing
     add ffffa1adfa ISIS-3304: promote Yaml utils from internal to public
     add e6f74baa86 ISIS-3304: YamlUtils polishing
     add 3947e8027b ISIS-3304: promote Jaxb utils from internal to public
     add ddac408c5d ISIS-3304: JaxbUtils: adding custom properties support
     add 74329d3c0d ISIS-3304: [Commons] rename Can random accessor methods ('orFail' -> 'elseFail')
     add b3dee83595 Bump vaadin.version from 23.2.11 to 23.3.0 (with fixes)
     add 09c528f345 Bump datanucleus-core from 6.0.2 to 6.0.3
     add a3fff98af4 Merge pull request #1270 from apache/dependabot/maven/master/org.datanucleus-datanucleus-core-6.0.3
     add 18ad616e31 Bump datanucleus-rdbms from 6.0.2 to 6.0.3
     add 668df60d54 Merge pull request #1271 from apache/dependabot/maven/master/org.datanucleus-datanucleus-rdbms-6.0.3
     add 746613a3c5 ISIS-3308: purge jdk-supplemental and cleanup core pom
     add 8220894066 ISIS-3308: purge legacy com.sun.xml.bind:jaxb-ri keep jaxb-impl
     add a27ea37b4d ISIS-3275: activate spring6 CI build on push (github)
     add f1a0250e31 Bump cucumber.version from 7.10.0 to 7.10.1
     add ce327e6b35 Merge pull request #1274 from apache/dependabot/maven/master/cucumber.version-7.10.1
     add 789a3e2661 Bump camel.version from 3.14.6 to 3.14.7
     add e9257aae0a Merge pull request #1276 from apache/dependabot/maven/master/camel.version-3.14.7
     add 77c0735db2 Bump maven-invoker-plugin from 3.3.0 to 3.4.0
     add 7331be855c Merge pull request #1280 from apache/dependabot/maven/master/org.apache.maven.plugins-maven-invoker-plugin-3.4.0
     add 8dfb9bf287 Bump jaxb-impl from 2.3.3 to 2.3.7
     add 675db087f7 Merge pull request #1275 from apache/dependabot/maven/master/com.sun.xml.bind-jaxb-impl-2.3.7
     add 298bee5355 Bump messages from 19.1.4 to 21.0.1
     add 7a35b856af Merge pull request #1277 from apache/dependabot/maven/master/io.cucumber-messages-21.0.1
     add 162adeb1d5 Bump vaadin.version from 23.3.0 to 23.3.1
     add f646bf4af6 Merge pull request #1288 from apache/dependabot/maven/master/vaadin.version-23.3.1
     add bd19d50bda ISIS-3309: fix for BookmarkedPagesPanel not AJAX updated on clear
     add 69085daf81 ISIS-3309: [Demo] Object Layout Annotation: adds VM stubs
     add ffe0cd279f ISIS-3309: [Demo] Object Layout Annotation: flesh out menu actions
     add 2763905841 ISIS-3315: adds test-case for ManagedObjects.NATURAL_NULL_FIRST comparator
     add 8ead825d78 ISIS-3316: JaxbService: remove potentially ambiguous methods from API
     add 8a5af84c41 ISIS-3316: use _ClassCache for check on presence of XmlRootElement annot.
     add a2b922438e Bump wicket-bootstrap.version from 6.0.0-M8 to 6.0.0
     add c3a663e87e ISIS-2445: BOM: replace javax-servlet artifact with jakarta equivalent
     add 3b820c96e3 ISIS-3316: JaxbService: encapsulates verbose exception handling with JaxbUtils
     add a494a9cc35 ISIS-3316: JaxbUtils: adds JUnit test to verify type-safe xml unmarshalling
     add 47f222c335 ISIS-3316: just comments
     add 5e93b51bd3 Bump structurizr-core from 1.16.1 to 1.16.2
     add 69ea832715 Merge pull request #1290 from apache/dependabot/maven/master/com.structurizr-structurizr-core-1.16.2
     add b699e21b97 Bump wagon-ftp from 3.5.2 to 3.5.3
     add 7846828bf0 Merge pull request #1294 from apache/dependabot/maven/master/org.apache.maven.wagon-wagon-ftp-3.5.3
     add 552c240157 Bump spring-boot-starter-parent from 2.7.6 to 2.7.7
     add 6067ef6fb5 Merge pull request #1293 from apache/dependabot/maven/master/org.springframework.boot-spring-boot-starter-parent-2.7.7
     add 77a4249c65 Bump spring-boot-maven-plugin from 2.7.6 to 2.7.7
     add ef1f414dfb Merge pull request #1295 from apache/dependabot/maven/master/org.springframework.boot-spring-boot-maven-plugin-2.7.7
     add 6288933bcf Bump spring-boot.version from 2.7.6 to 2.7.7
     add e716ae8e11 Merge pull request #1296 from apache/dependabot/maven/master/spring-boot.version-2.7.7
     add 32831c6969 Bump wagon-ssh from 3.5.2 to 3.5.3
     add 7c658a3ce9 Merge pull request #1297 from apache/dependabot/maven/master/org.apache.maven.wagon-wagon-ssh-3.5.3
     new 0289e6bf92 ISIS-3255: updates index.html with warning re: Windows classpath length limits
     new 39215d3440 ISIS-3255: adds docs on using ACA to host nightlies

This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version.  This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:

 * -- * -- B -- O -- O -- O   (60c1255876)
            \
             N -- N -- N   refs/heads/ISIS-3255 (39215d3440)

You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.

Any revisions marked "omit" are not gone; other references still
refer to them.  Any revisions marked "discard" are gone forever.

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 .../workflows/ci-build-artifacts-no-push-maven.yml |    2 +
 .../images/image-2023-01-02-11-10-57-742.png       |  Bin 0 -> 399828 bytes
 .../images/image-2023-01-02-11-15-22-937.png       |  Bin 0 -> 177254 bytes
 .../images/image-2023-01-02-11-37-15-599.png       |  Bin 0 -> 277941 bytes
 .../images/image-2023-01-02-11-39-16-947.png       |  Bin 0 -> 123243 bytes
 .../images/image-2023-01-02-11-41-34-824.png       |  Bin 0 -> 53087 bytes
 .../images/image-2023-01-02-18-54-07-844.png       |  Bin 0 -> 44438 bytes
 .../images/image-2023-01-02-18-55-22-599.png       |  Bin 0 -> 43113 bytes
 .../images/image-2023-01-02-18-57-10-836.png       |  Bin 0 -> 30196 bytes
 .../images/image-2023-01-03-08-31-58-018.png       |  Bin 0 -> 77018 bytes
 .../components/conguide/modules/nightlies/nav.adoc |    4 +
 .../conguide/modules/nightlies/pages/about.adoc    |  430 ++
 api/applib/pom.xml                                 |   13 +-
 api/applib/src/main/java/module-info.java          |    2 +-
 .../appfeatui/ApplicationFeatureViewModel.java     |    2 +-
 .../causeway/applib/services/jaxb/JaxbService.java |  132 +-
 .../services/metamodel/MetaModelServiceMenu.java   |   14 +-
 .../services/publishing/log/CommandLogger.java     |    4 +-
 .../publishing/log/EntityChangesLogger.java        |    2 +-
 .../services/publishing/log/ExecutionLogger.java   |    2 +-
 .../org/apache/causeway/applib/util/JaxbUtil.java  |  137 +-
 .../applib/util/schema/ChangesDtoUtils.java        |   83 +-
 .../applib/util/schema/CommandDtoUtils.java        |   94 +-
 .../applib/util/schema/CommonDtoUtils.java         |   27 +-
 .../applib/util/schema/InteractionDtoUtils.java    |  120 +-
 .../applib/util/schema/InteractionsDtoUtils.java   |   77 +-
 .../util/schema/MemberExecutionDtoUtils.java       |   56 +-
 .../applib/services/jaxb/JaxbServiceTest.java      |    7 +-
 api/schema/pom.xml                                 |   45 +-
 api/schema/src/main/java/module-info.java          |    2 +-
 .../causeway/schema/metamodel/metamodel-2.0.xsd    |  386 --
 .../{org/apache/causeway => }/schema/bindings.xml  |    0
 .../apache/causeway => }/schema/chg/chg-2.0.xsd    |   11 +-
 .../apache/causeway => }/schema/cmd/cmd-2.0.xsd    |   34 +-
 .../causeway => }/schema/common/common-2.0.xsd     |   69 +-
 .../apache/causeway => }/schema/ixn/ixn-2.0.xsd    |   40 +-
 .../resources/schema/metamodel/metamodel-2.0.xsd   |  498 ++
 bom/pom.xml                                        |  719 ++-
 commons/pom.xml                                    |   61 +-
 commons/src/main/java/module-info.java             |    3 +
 .../apache/causeway/commons/collections/Can.java   |    4 +-
 .../commons/collections/Can_Singleton.java         |    2 +-
 .../apache/causeway/commons/functional/Try.java    |    5 +
 .../commons/internal/ioc/_IocContainer.java        |    2 +-
 .../commons/internal/reflection/_ClassCache.java   |   21 +-
 .../commons/internal/resources/_DataSink.java      |   35 -
 .../commons/internal/resources/_DataSource.java    |  139 -
 .../causeway/commons/internal/resources/_Json.java |  246 -
 .../causeway/commons/internal/resources/_Xml.java  |  231 -
 .../causeway/commons/internal/resources/_Yaml.java |  168 -
 .../org/apache/causeway/commons/io/DataSink.java   |  106 +
 .../org/apache/causeway/commons/io/DataSource.java |   96 +
 .../org/apache/causeway/commons/io/DtoMapper.java  |   69 +
 .../org/apache/causeway/commons/io/JaxbUtils.java  |  359 ++
 .../org/apache/causeway/commons/io/JsonUtils.java  |  151 +
 .../org/apache/causeway/commons/io/YamlUtils.java  |  130 +
 .../commons/resource/ResourceCoordinates.java      |    3 +-
 .../internal/resources/JsonYamlReaderTest.java     |   20 +-
 .../internal/resources/XmlRoundTripTest.java       |   31 +-
 .../apache/causeway/commons/io/JaxbUtilsTest.java  |   88 +
 core/config/pom.xml                                |   10 +-
 .../beans/CausewayBeanTypeClassifierDefault.java   |    5 +-
 .../environment/CausewaySystemEnvironment.java     |   20 +-
 core/jdk-supplemental/pom.xml                      |  247 -
 .../_testing/MetaModelContext_forTesting.java      |    2 +-
 .../_testing/ServiceRegistry_forTesting.java       |    2 +-
 .../core/metamodel/facetapi/FacetRanking.java      |    2 +-
 .../core/metamodel/facets/ImperativeAspect.java    |    2 +-
 ...ctionInvocationFacetForDomainEventAbstract.java |    4 +-
 .../ActionParameterValidationFacetViaMethod.java   |    2 +-
 .../method/ActionValidationFacetViaMethod.java     |    2 +-
 .../CollectionAccessorFacetViaAccessor.java        |    2 +-
 .../method/DisableForContextFacetViaMethod.java    |    2 +-
 .../method/HideForContextFacetViaMethod.java       |    2 +-
 .../object/viewmodel/ViewModelFacetFactory.java    |    6 +-
 .../ViewModelFacetForXmlRootElementAnnotation.java |   10 +-
 .../ActionParameterAutoCompleteFacetViaMethod.java |    2 +-
 .../ActionParameterChoicesFacetViaMethod.java      |    2 +-
 .../ActionParameterDefaultsFacetViaMethod.java     |    2 +-
 .../ActionParameterDisabledFacetViaMethod.java     |    2 +-
 .../ActionParameterHiddenFacetViaMethod.java       |    2 +-
 .../ActionParameterValidationFacetViaMethod.java   |    2 +-
 .../accessor/PropertyAccessorFacetViaAccessor.java |    2 +-
 .../method/PropertyAutoCompleteFacetMethod.java    |    2 +-
 .../method/PropertyChoicesFacetViaMethod.java      |    2 +-
 .../method/PropertyDefaultFacetViaMethod.java      |    2 +-
 .../clear/PropertyClearFacetViaClearMethod.java    |    2 +-
 .../clear/PropertyClearFacetViaSetterMethod.java   |    2 +-
 ...PropertyInitializationFacetViaSetterMethod.java |    2 +-
 .../modify/PropertySetterFacetViaSetterMethod.java |    2 +-
 .../core/metamodel/object/ManagedObjects.java      |    2 +-
 .../bootstrap/GridMarshallerServiceBootstrap.java  |   32 +-
 .../services/layout/LayoutServiceDefault.java      |    2 +-
 .../services/metamodel/DomainMemberDefault.java    |    2 +-
 ...etaModelValidatorForConflictingOptionality.java |    2 +-
 .../valuesemantics/ChangesDtoValueSemantics.java   |    4 +-
 .../valuesemantics/CommandDtoValueSemantics.java   |    4 +-
 .../InteractionDtoValueSemantics.java              |    4 +-
 .../actions/ActionMethodsFacetFactoryTest.java     |   16 +-
 ...nnotationFacetFactoryTest_ActionInvocation.java |    8 +-
 .../CollectionFieldMethodsFacetFactoryTest.java    |   12 +-
 .../title/TitleFacetViaMethodsFactoryTest.java     |    2 +-
 .../PropertyMethodsFacetFactoryTest.java           |   30 +-
 .../core/metamodel/object/ManagedObjectTest.java   |  121 +
 .../objects/OneToManyAssociationDefaultTest.java   |    3 +-
 .../metamodel/services/grid/GridLoadingTest.java   |    2 +-
 core/pom.xml                                       |  664 +-
 core/runtimeservices/pom.xml                       |    5 +
 .../core/runtimeservices/executor/_Xray.java       |    8 +-
 .../runtimeservices/jaxb/JaxbServiceDefault.java   |   53 +-
 .../core/runtimeservices/publish/_Xray.java        |   10 +-
 .../menubars/bootstrap/MenuBarsServiceBSTest.java  |    2 +-
 .../dom/domain/_interactions/InteractionDtoVm.java |    4 +-
 .../DomainObjectLayout/DomainObjectLayoutMenu.java |  111 +-
 .../DomainObjectLayoutBookmarkingVm.java           |   58 +
 .../cssClass/DomainObjectLayoutCssClassVm.java     |   58 +
 .../cssClassFa/DomainObjectLayoutCssClassFaVm.java |   58 +
 .../DomainObjectLayoutDescribedAsVm.java           |   58 +
 .../named/DomainObjectLayoutNamedVm.java           |   58 +
 .../paged/DomainObjectLayoutPagedVm.java           |   58 +
 .../plural/DomainObjectLayoutPluralVm.java         |   58 +
 .../xxxUiEvent/DomainObjectLayoutXxxUiEventVm.java |   58 +
 .../applib/dom/CommandLogEntryRepository.java      |    6 +-
 .../applib/job/RunBackgroundCommandsJob.java       |    5 +-
 .../subscriber/CommandSubscriberForCommandLog.java |    9 +-
 .../applib/dom/ExecutionOutboxEntryRepository.java |    7 +-
 .../applib/restapi/OutboxRestApi.java              |    2 +-
 .../restclient/api/OutboxClient.java               |    6 +-
 .../secman/applib/util/ApplicationSecurityDto.java |    4 +-
 .../CollectionContentsAsExcelFactory.java          |    4 +-
 .../pdfjs/applib/config/PdfJsConfig.java           |    4 +-
 .../CausewayModuleIncViewerVaadinViewer.java       |    6 +-
 .../jpa/integration/changetracking/_Xray.java      |    4 +-
 .../schema/v2/CausewayChangesDtoConverter.java     |    8 +-
 .../schema/v2/CausewayCommandDtoConverter.java     |    8 +-
 .../schema/v2/CausewayInteractionDtoConverter.java |    8 +-
 .../schema/v2/CausewayChangesDtoConverter.java     |    8 +-
 .../schema/v2/CausewayCommandDtoConverter.java     |    8 +-
 .../schema/v2/CausewayInteractionDtoConverter.java |    8 +-
 .../DomainModelTest_usingGoodDomain.java           |    6 +-
 .../domainmodel/MetaModelRegressionTest.java       |   73 +-
 .../MetaModelRegressionTest.verify.approved.xml    | 6466 ++++++++++----------
 .../testdomain/value/ValueSemanticsTester.java     |   12 +-
 .../EntityChangesSubscriberForTesting.java         |   18 +-
 .../subscriber/ExecutionSubscriberForTesting.java  |    2 +-
 starters/pom.xml                                   |    4 +-
 testing/archtestsupport/applib/pom.xml             |    5 +-
 testing/specsupport/applib/pom.xml                 |    2 +-
 testing/unittestsupport/applib/pom.xml             |   14 +-
 .../org/apache/causeway/tooling/cli/CliConfig.java |    5 +-
 .../causeway/tooling/cli/test/CliConfigTest.java   |   10 +-
 tooling/javamodel/pom.xml                          |    2 +-
 tooling/pom.xml                                    |    2 +-
 .../valuetypes/vega/applib/value/Vega.java         |    5 +-
 .../restfulobjects/applib/JsonRepresentation.java  |   70 +-
 viewers/restfulobjects/jaxrs-resteasy/pom.xml      |    2 +-
 .../conneg/ContentNegotiationServiceAbstract.java  |    4 +-
 .../viewer/resources/_EndpointLogging.java         |    9 +-
 .../serialization/SerializationStrategy.java       |   12 +-
 viewers/wicket/applib/pom.xml                      |    6 +
 .../wicket/applib/src/main/java/module-info.java   |    1 -
 .../actionresponse/ActionResultResponseType.java   |    2 +-
 .../bookmarkedpages/BookmarkedPagesPanel.java      |    3 +-
 .../CollectionPresentationSelectorPanel.html       |    6 +-
 .../CollectionPresentationSelectorPanel.java       |   15 +-
 165 files changed, 7370 insertions(+), 6388 deletions(-)
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png
 create mode 100644 antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png
 create mode 100644 antora/components/conguide/modules/nightlies/nav.adoc
 create mode 100644 antora/components/conguide/modules/nightlies/pages/about.adoc
 delete mode 100644 api/schema/src/main/resources/org/apache/causeway/schema/metamodel/metamodel-2.0.xsd
 rename api/schema/src/main/resources/{org/apache/causeway => }/schema/bindings.xml (100%)
 rename api/schema/src/main/resources/{org/apache/causeway => }/schema/chg/chg-2.0.xsd (91%)
 rename api/schema/src/main/resources/{org/apache/causeway => }/schema/cmd/cmd-2.0.xsd (86%)
 rename api/schema/src/main/resources/{org/apache/causeway => }/schema/common/common-2.0.xsd (74%)
 rename api/schema/src/main/resources/{org/apache/causeway => }/schema/ixn/ixn-2.0.xsd (87%)
 create mode 100644 api/schema/src/main/resources/schema/metamodel/metamodel-2.0.xsd
 delete mode 100644 commons/src/main/java/org/apache/causeway/commons/internal/resources/_DataSink.java
 delete mode 100644 commons/src/main/java/org/apache/causeway/commons/internal/resources/_DataSource.java
 delete mode 100644 commons/src/main/java/org/apache/causeway/commons/internal/resources/_Json.java
 delete mode 100644 commons/src/main/java/org/apache/causeway/commons/internal/resources/_Xml.java
 delete mode 100644 commons/src/main/java/org/apache/causeway/commons/internal/resources/_Yaml.java
 create mode 100644 commons/src/main/java/org/apache/causeway/commons/io/DataSink.java
 create mode 100644 commons/src/main/java/org/apache/causeway/commons/io/DataSource.java
 create mode 100644 commons/src/main/java/org/apache/causeway/commons/io/DtoMapper.java
 create mode 100644 commons/src/main/java/org/apache/causeway/commons/io/JaxbUtils.java
 create mode 100644 commons/src/main/java/org/apache/causeway/commons/io/JsonUtils.java
 create mode 100644 commons/src/main/java/org/apache/causeway/commons/io/YamlUtils.java
 create mode 100644 commons/src/test/java/org/apache/causeway/commons/io/JaxbUtilsTest.java
 delete mode 100644 core/jdk-supplemental/pom.xml
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/bookmarking/DomainObjectLayoutBookmarkingVm.java
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/cssClass/DomainObjectLayoutCssClassVm.java
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/cssClassFa/DomainObjectLayoutCssClassFaVm.java
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/describedAs/DomainObjectLayoutDescribedAsVm.java
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/named/DomainObjectLayoutNamedVm.java
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/paged/DomainObjectLayoutPagedVm.java
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/plural/DomainObjectLayoutPluralVm.java
 create mode 100644 examples/demo/domain/src/main/java/demoapp/dom/domain/objects/DomainObjectLayout/xxxUiEvent/DomainObjectLayoutXxxUiEventVm.java


[isis] 01/02: ISIS-3255: updates index.html with warning re: Windows classpath length limits

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 0289e6bf9295934c2a0c5b719b5fc9cb2b9375f6
Author: Dan Haywood <da...@haywood-associates.co.uk>
AuthorDate: Wed Dec 14 23:34:54 2022 +0000

    ISIS-3255: updates index.html with warning re: Windows classpath length limits
---
 antora/supplemental-ui/index.html | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/antora/supplemental-ui/index.html b/antora/supplemental-ui/index.html
index 4a313fa5de..cccbb72fcf 100644
--- a/antora/supplemental-ui/index.html
+++ b/antora/supplemental-ui/index.html
@@ -540,16 +540,24 @@
           <h3 class="cta-title">Quick Start</h3>
 
           <div class="row">
+            <div class="col-lg-12 text-left text-lg-left">
+              <p class="cta-text text-center" style="margin-block-end: 0; ">
+                Prereqs: Java 11 and Maven 3.6+.  <br/>
+                We recommend you try out using Linux, MacOS or WSL2 <br/>
+                (to <a href="https://github.com/spring-projects/spring-boot/issues/17766">avoid exceeding</a> Windows' limits due to classpath length).
+              </p>
+              <br/>
+            </div>
             <div class="col-lg-6 text-left text-lg-left">
               <p class="cta-text text-center" style="margin-block-end: 0; ">
                 Learn about Apache Isis™ by running the minimal <a href="docs/latest/starters/helloworld.html">helloworld</a> starter&nbsp;app.
-                You can see the app running <a href="https://helloworld.jdo.isis.incode.work/" target="_blank">here (jdo)</a> and <a href="https://helloworld.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
+                You can see the app running <a href="https://helloworld.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://helloworld.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
               </p>
             </div>
             <div class="col-lg-6 text-left text-lg-left">
               <p class="cta-text text-center" style="margin-block-end: 0; ">
                 Develop your own Apache Isis™ app with the structured <a href="docs/latest/starters/simpleapp.html">simpleapp</a> starter&nbsp;app.
-                You can see the app running <a href="https://simpleapp.jdo.isis.incode.work/" target="_blank">here (jdo)</a> and <a href="https://simpleapp.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
+                You can see the app running <a href="https://simpleapp.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://simpleapp.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
               </p>
             </div>
           </div>
@@ -562,7 +570,7 @@ BRANCH=jdo
 curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
 cd $APP-$BRANCH
 
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
 mvn spring-boot:run</pre>
               </p>
             </div>
@@ -574,7 +582,7 @@ BRANCH=jdo
 curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
 cd $APP-$BRANCH
 
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
 mvn -pl webapp spring-boot:run</pre>
               </p>
             </div>
@@ -600,7 +608,7 @@ BRANCH=jpa
 curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
 cd $APP-$BRANCH
 
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
 mvn spring-boot:run</pre>
               </p>
             </div>
@@ -612,7 +620,7 @@ BRANCH=jpa
 curl https://codeload.github.com/apache/$APP/zip/$BRANCH | jar xv
 cd $APP-$BRANCH
 
-mvn clean install
+mvn clean install -Dskip.staging -Dskip.nightly
 mvn -pl webapp spring-boot:run</pre>
               </p>
             </div>
@@ -632,7 +640,7 @@ mvn -pl webapp spring-boot:run</pre>
           <div class="row">
             <div class="col-lg-12 text-left text-lg-left">
               <p class="cta-text text-center" style="margin-block-end: 0; margin-top: 20px;">
-                You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket.isis.incode.work/" target="_blank">here</a>.
+                You can also explore the Apache Isis programming model through the demo app, running <a href="https://demo-wicket.jdo.isis.incode.work/" target="_blank">here (jdo)</a> or <a href="https://demo-wicket.jpa.isis.incode.work/" target="_blank">here (jpa)</a>.
               </p>
             </div>
           </div>


[isis] 02/02: ISIS-3255: adds docs on using ACA to host nightlies

Posted by da...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

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

commit 39215d3440d1dd6b7497cbf442b58c4b29c57f9e
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Tue Jan 3 08:34:38 2023 +0000

    ISIS-3255: adds docs on using ACA to host nightlies
---
 .../images/image-2023-01-02-11-10-57-742.png       | Bin 0 -> 399828 bytes
 .../images/image-2023-01-02-11-15-22-937.png       | Bin 0 -> 177254 bytes
 .../images/image-2023-01-02-11-37-15-599.png       | Bin 0 -> 277941 bytes
 .../images/image-2023-01-02-11-39-16-947.png       | Bin 0 -> 123243 bytes
 .../images/image-2023-01-02-11-41-34-824.png       | Bin 0 -> 53087 bytes
 .../images/image-2023-01-02-18-54-07-844.png       | Bin 0 -> 44438 bytes
 .../images/image-2023-01-02-18-55-22-599.png       | Bin 0 -> 43113 bytes
 .../images/image-2023-01-02-18-57-10-836.png       | Bin 0 -> 30196 bytes
 .../images/image-2023-01-03-08-31-58-018.png       | Bin 0 -> 77018 bytes
 .../components/conguide/modules/nightlies/nav.adoc |   4 +
 .../conguide/modules/nightlies/pages/about.adoc    | 430 +++++++++++++++++++++
 11 files changed, 434 insertions(+)

diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png
new file mode 100644
index 0000000000..e07f4a0203
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-10-57-742.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png
new file mode 100644
index 0000000000..acc9c9624a
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-15-22-937.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png
new file mode 100644
index 0000000000..a4fac01fc6
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-37-15-599.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png
new file mode 100644
index 0000000000..d373338784
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-39-16-947.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png
new file mode 100644
index 0000000000..e55eb0e9e0
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-11-41-34-824.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png
new file mode 100644
index 0000000000..58659be179
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-54-07-844.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png
new file mode 100644
index 0000000000..b67fb6242f
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-55-22-599.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png
new file mode 100644
index 0000000000..127baf44c5
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-02-18-57-10-836.png differ
diff --git a/antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png
new file mode 100644
index 0000000000..ed5aaa58db
Binary files /dev/null and b/antora/components/conguide/modules/nightlies/images/image-2023-01-03-08-31-58-018.png differ
diff --git a/antora/components/conguide/modules/nightlies/nav.adoc b/antora/components/conguide/modules/nightlies/nav.adoc
new file mode 100644
index 0000000000..744f63c485
--- /dev/null
+++ b/antora/components/conguide/modules/nightlies/nav.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 [...]
+
+* xref:conguide:nightlies:about.adoc[Nightlies]
diff --git a/antora/components/conguide/modules/nightlies/pages/about.adoc b/antora/components/conguide/modules/nightlies/pages/about.adoc
new file mode 100644
index 0000000000..d9c99f0587
--- /dev/null
+++ b/antora/components/conguide/modules/nightlies/pages/about.adoc
@@ -0,0 +1,430 @@
+[[nightlies]]
+= Nightlies
+
+: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 page describes how we deploy the xref:docs:starters:simpleapp.adoc[], xref:docs:starters:helloworld.adoc[HelloWorld App] and the xref:docs:demo:about.adoc[] each night.
+
+WARNING: work in progress
+
+The intention is to use link:https://learn.microsoft.com/en-gb/azure/container-apps/[Azure Container Apps].
+
+== Azure Container Apps
+
+Following link:https://learn.microsoft.com/en-gb/azure/container-apps/get-started?ocid=AID3042118&tabs=bash[azure docs] for ACA
+
+=== Prereqs
+
+* link:https://learn.microsoft.com/en-us/cli/azure/install-azure-cli[install Azure CLI]
+
+=== Authenticate
+
+Authenticate and prepare working environment
+
+* login
++
+[source,bash]
+----
+az login
+----
++
+Confirm using web browser.
+
+* add ACA extension
++
+[source,bash]
+----
+az extension add --name containerapp --upgrade
+----
++
+This takes a minute or two.
+
+* register the `Microsoft.OperationalInsights` provider for the Azure Monitor Log Analytics workspace
++
+[source,bash]
+----
+az provider register --namespace Microsoft.OperationalInsights
+----
++
+(as have not used it before).
+
+
+
+=== Setup
+
+Create a resource group to organize the services related to the container apps.
+
+* set the environment variables:
++
+[source,bash]
+----
+RESOURCE_GROUP="causeway-nightlies-rg"
+LOCATION="uksouth"
+----
+
+* create the resource group
++
+[source,bash]
+----
+az group create \
+  --name $RESOURCE_GROUP \
+  --location $LOCATION
+----
++
+resulting in:
++
+[source,bash]
+----
+{
+  "id": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg",
+  "location": "ukwest",
+  "managedBy": null,
+  "name": "causeway-nightlies-rg",
+  "properties": {
+    "provisioningState": "Succeeded"
+  },
+  "tags": null,
+  "type": "Microsoft.Resources/resourceGroups"
+}
+----
+
+=== Create an environment
+
+An environment in Azure Container Apps creates a secure boundary around a group of container apps.
+Container Apps deployed to the same environment are deployed in the same virtual network and write logs to the same Log Analytics workspace.
+
+* set a further environment variable:
++
+[source,bash]
+----
+CONTAINERAPPS_ENVIRONMENT="causeway-nightlies-aca-env"
+----
+
+* xxx
++
+[source,bash]
+----
+az containerapp env create \
+  --name $CONTAINERAPPS_ENVIRONMENT \
+  --resource-group $RESOURCE_GROUP \
+  --location $LOCATION
+----
++
+resulting in:
++
+[source,bash]
+----
+No Log Analytics workspace provided.
+Generating a Log Analytics workspace with name "workspace-causewaynightliesrgT0WN"
+
+Container Apps environment created. To deploy a container app, use: az containerapp create --help
+
+{
+  "id": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
+  "location": "uksouth",
+  "name": "causeway-nightlies-aca-env",
+  "properties": {
+    "appLogsConfiguration": {
+      "destination": "log-analytics",
+      "logAnalyticsConfiguration": {
+        "customerId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
+      }
+    },
+    "customDomainConfiguration": {
+      "customDomainVerificationId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
+    },
+    "defaultDomain": "graytree-90c75749.uksouth.azurecontainerapps.io",
+    "provisioningState": "Succeeded",
+    "staticIp": "20.108.221.167",
+    "zoneRedundant": false
+  },
+  "resourceGroup": "causeway-nightlies-rg",
+  "sku": {
+    "name": "Consumption"
+  },
+  "systemData": {
+    "createdAt": "2023-01-02T06:54:25.6911574",
+    "createdBy": "dan@haywood-associates.co.uk",
+    "createdByType": "User",
+    "lastModifiedAt": "2023-01-02T06:54:25.6911574",
+    "lastModifiedBy": "dan@haywood-associates.co.uk",
+    "lastModifiedByType": "User"
+  },
+  "type": "Microsoft.App/managedEnvironments"
+}
+----
+
+=== Create container apps
+
+For link:https://hub.docker.com/repository/docker/apacheisis/demo-wicket-jpa[apacheisis/demo-wicket-jpa]
+
+* set a further environment variables:
++
+[source,bash]
+----
+APP_NAME="demo-wicket-jpa"
+IMAGE_NAME="apacheisis/demo-wicket-jpa"
+IMAGE_VERSION="2.0.0-M9.20221224-0226-7c658a3c"
+----
+
+* create the app
++
+[source,bash]
+----
+az containerapp create \
+  --name $APP_NAME \
+  --resource-group $RESOURCE_GROUP \
+  --environment $CONTAINERAPPS_ENVIRONMENT \
+  --image $IMAGE_NAME:$IMAGE_VERSION \
+  --target-port 8080 \
+  --ingress 'external' \
+  --query properties.configuration.ingress.fqdn
+----
++
+resulting in:
++
+[source,bash]
+----
+Container app created. Access your app at https://demo-wicket-jpa.graytree-90c75749.uksouth.azurecontainerapps.io/
+----
+
+=== Update the app
+
+* update the environment variables:
++
+[source,bash]
+----
+IMAGE_VERSION="2.0.0-M9.20221229-0233-"
+----
++
+NOTE: looks like there's an issue with our generation of the image version, missing the sha Id suffix.
+
+* Update the image
++
+[source,bash]
+----
+az containerapp update \
+  --name $APP_NAME \
+  --resource-group $RESOURCE_GROUP \
+  --image $IMAGE_NAME:$IMAGE_VERSION
+----
++
+resulting in:
++
+[source,bash]
+----
+{
+  "id": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/containerapps/demo-wicket-jpa",
+  "identity": {
+    "type": "None"
+  },
+  "location": "UK South",
+  "name": "demo-wicket-jpa",
+  "properties": {
+    "configuration": {
+      "activeRevisionsMode": "Single",
+      "dapr": null,
+      "ingress": {
+        "allowInsecure": false,
+        "customDomains": null,
+        "exposedPort": 0,
+        "external": true,
+        "fqdn": "demo-wicket-jpa.graytree-90c75749.uksouth.azurecontainerapps.io",
+        "ipSecurityRestrictions": null,
+        "targetPort": 8080,
+        "traffic": [
+          {
+            "latestRevision": true,
+            "weight": 100
+          }
+        ],
+        "transport": "Auto"
+      },
+      "maxInactiveRevisions": null,
+      "registries": null,
+      "secrets": null
+    },
+    "customDomainVerificationId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
+    "environmentId": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
+    "eventStreamEndpoint": "https://uksouth.azurecontainerapps.dev/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/containerApps/demo-wicket-jpa/eventstream",
+    "latestRevisionFqdn": "demo-wicket-jpa--hg9md16.graytree-90c75749.uksouth.azurecontainerapps.io",
+    "latestRevisionName": "demo-wicket-jpa--hg9md16",
+    "managedEnvironmentId": "/subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/causeway-nightlies-rg/providers/Microsoft.App/managedEnvironments/causeway-nightlies-aca-env",
+    "outboundIpAddresses": [
+      "20.108.221.63"
+    ],
+    "provisioningState": "Succeeded",
+    "template": {
+      "containers": [
+        {
+          "image": "apacheisis/demo-wicket-jpa:2.0.0-M9.20221224-0226-7c658a3c",
+          "name": "demo-wicket-jpa",
+          "resources": {
+            "cpu": 0.5,
+            "ephemeralStorage": "1Gi",
+            "memory": "1Gi"
+          }
+        }
+      ],
+      "initContainers": null,
+      "revisionSuffix": "",
+      "scale": {
+        "maxReplicas": 10,
+        "minReplicas": null,
+        "rules": null
+      },
+      "volumes": null
+    },
+    "workloadProfileType": null
+  },
+  "resourceGroup": "causeway-nightlies-rg",
+  "systemData": {
+    "createdAt": "2023-01-02T07:06:17.4141558",
+    "createdBy": "dan@haywood-associates.co.uk",
+    "createdByType": "User",
+    "lastModifiedAt": "2023-01-02T07:12:31.4804896",
+    "lastModifiedBy": "dan@haywood-associates.co.uk",
+    "lastModifiedByType": "User"
+  },
+  "type": "Microsoft.App/containerApps"
+}
+----
+
+== Custom domain
+
+=== Create self-signed certificate
+
+* create `
++
+[source,bash]
+----
+openssl req -new -newkey RSA:2048 -nodes -keyout ssl.key -out ssl.csr
+----
++
+resulting in:
++
+[source,bash]
+----
+Generating a RSA private key
+...............................+++++
+.+++++
+writing new private key to 'ssl.key'
+-----
+You are about to be asked to enter information that will be incorporated
+into your certificate request.
+What you are about to enter is what is called a Distinguished Name or a DN.
+There are quite a few fields but you can leave some blank
+For some fields there will be a default value,
+If you enter '.', the field will be left blank.
+-----
+Country Name (2 letter code) [AU]:UK
+State or Province Name (full name) [Some-State]:Worcestershire
+Locality Name (eg, city) []:Malvern
+Organization Name (eg, company) [Internet Widgits Pty Ltd]:Haywood Associates Ltd.
+Organizational Unit Name (eg, section) []:
+Common Name (e.g. server FQDN or YOUR name) []:*.isis.incode.work
+Email Address []:dan@haywood-associates.co.uk
+
+Please enter the following 'extra' attributes
+to be sent with your certificate request
+A challenge password []:
+An optional company name []:Haywood Associates Ltd.
+----
++
+which results in two files:
+
+** `ssl.csr`
+** `ssl.key`
+
+* create the `.crt` self-signed certificate:
++
+[source,bash]
+----
+openssl x509 -req -days 365 -in ssl.csr -signkey ssl.key -out ssl.crt
+----
++
+resulting in:
++
+[source,bash]
+----
+Signature ok
+subject=C = UK, ST = Worcestershire, L = Malvern, O = Haywood Associates Ltd., CN = *.isis.incode.work, emailAddress = dan@haywood-associates.co.uk
+Getting Private key
+----
++
+and the additional file:
+
+** `ssl.crt`
+
+
+* convert to a PKCS12 (`.pfx`) file
++
+[source,bash]
+----
+openssl pkcs12 -inkey ssl.key -in ssl.crt -export -out ssl.pfx
+----
++
+resulting in:
++
+[source,bash]
+----
+Enter Export Password:
+Verifying - Enter Export Password:
+----
++
+and the additional file:
+
+** `ssl.pfx`
+
+
+
+=== Add Custom domain and bind to cert
+
+As per MS docs on https://learn.microsoft.com/en-us/azure/container-apps/custom-domains-certificates[adding custom domain & certificates]
+
+in Azure Portal:
+
+* locate IP:
++
+image::image-2023-01-02-11-10-57-742.png[width=800px]
+
+* add custom domain:
++
+image::image-2023-01-02-11-15-22-937.png[width=400]
+
+in DNS nameserver (eg held by registrar)
+
+* add DNS records:
++
+image::image-2023-01-02-11-37-15-599.png[width=800]
+
+in Azure Portal:
+
+* validate:
++
+image::image-2023-01-02-11-39-16-947.png[width=400]
+
+* next:
++
+image::image-2023-01-02-11-41-34-824.png[width=400]
+
+* use `create new` link
++
+upload the .pfx file created earlier, and validate:
++
+image::image-2023-01-02-18-54-07-844.png[width=400]
+
+* confirm
++
+image::image-2023-01-02-18-55-22-599.png[width=400]
+
+* listed:
++
+image::image-2023-01-02-18-57-10-836.png[width=800]
+
+
+* Change scaling from default (1-10) to just a single instance.
++
+image::image-2023-01-03-08-31-58-018.png[width=600]
+