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 2020/01/31 19:25:50 UTC
[isis] 05/09: ISIS-2062: replaces links to the starter app git
repos with the xref: starter apps pages.
This is an automated email from the ASF dual-hosted git repository.
danhaywood pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git
commit b4332bed088b514daf1d0d36b2944c9fc0d4267a
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Fri Jan 31 18:07:28 2020 +0000
ISIS-2062: replaces links to the starter app git repos with the xref: starter apps pages.
---
antora/toc/modules/ROOT/pages/downloads/how-to.adoc | 2 +-
antora/toc/modules/ROOT/pages/more-thanks/more-thanks.adoc | 2 +-
.../ROOT/pages/what-is-apache-isis/screencasts-older.adoc | 4 ++--
.../modules/ROOT/pages/what-is-apache-isis/screencasts.adoc | 2 +-
antora/toc/modules/comguide/pages/verifying-releases.adoc | 2 +-
.../devguide/pages/hints-and-tips/datanucleus-enhancer.adoc | 4 ++--
.../pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc | 2 +-
antora/toc/modules/devguide/pages/ide/eclipse.adoc | 4 ++--
api/adoc/userguide/modules/btb/pages/i18n.adoc | 2 +-
api/adoc/userguide/modules/fun/pages/about.adoc | 2 +-
.../fun/pages/core-concepts/philosophy/how-eases-ddd.adoc | 2 +-
.../modules/fun/pages/programming-model/properties.adoc | 2 +-
.../applib-cm/pages/classes/AppManifest-bootstrapping.adoc | 2 +-
.../pages/testing/FixtureScriptsSpecificationProvider.adoc | 2 +-
.../main/adoc/modules/config/pages/specifying-components.adoc | 2 +-
extensions/core/flyway/adoc/modules/flyway/pages/about.adoc | 2 +-
.../mavenplugin/src/main/doc/modules/mvn/pages/intro.adoc | 2 +-
.../mavenplugin/src/main/doc/modules/mvn/pages/validate.adoc | 2 +-
.../configuring/disabling-persistence-by-reachability.adoc | 2 +-
.../adoc/modules/ROOT/pages/configuring/persistence-xml.adoc | 2 +-
security/adoc/modules/ROOT/pages/about.adoc | 2 +-
.../shiro/pages/about/configuring-isis-to-use-shiro.adoc | 4 ++--
.../src/main/adoc/modules/shiro/pages/about/ini-realm.adoc | 2 +-
.../modules/fixtures/pages/fixture-scripts/api-and-usage.adoc | 10 +++++-----
.../adoc/modules/ROOT/pages/layout-resources.adoc | 4 ++--
viewers/wicket/adoc/modules/ROOT/pages/layout/file-based.adoc | 2 +-
.../adoc/modules/ROOT/pages/menubars-layout/file-based.adoc | 2 +-
27 files changed, 36 insertions(+), 36 deletions(-)
diff --git a/antora/toc/modules/ROOT/pages/downloads/how-to.adoc b/antora/toc/modules/ROOT/pages/downloads/how-to.adoc
index 5a08c5c..405e236 100644
--- a/antora/toc/modules/ROOT/pages/downloads/how-to.adoc
+++ b/antora/toc/modules/ROOT/pages/downloads/how-to.adoc
@@ -12,7 +12,7 @@ Use for prototyping or production.
== Getting Started
-If you just want to get going quickly, we suggest using our link:https://github.com/apache/isis-app-helloworld[HelloWorld] or link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps.
+If you just want to get going quickly, we suggest using our xref:starters:helloworld:about.adoc[HelloWorld] or xref:starters:simpleapp:about.adoc[SimpleApp] starter apps.
diff --git a/antora/toc/modules/ROOT/pages/more-thanks/more-thanks.adoc b/antora/toc/modules/ROOT/pages/more-thanks/more-thanks.adoc
index 71b3433..8f8f971 100644
--- a/antora/toc/modules/ROOT/pages/more-thanks/more-thanks.adoc
+++ b/antora/toc/modules/ROOT/pages/more-thanks/more-thanks.adoc
@@ -23,7 +23,7 @@ In addition to the http://www.apache.org/foundation/thanks.html[support given to
|image::more-thanks/icons8-logo.png[link="http://icons8.com"]
-|Icons8, for selected icons on this website and in the link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps
+|Icons8, for selected icons on this website and in the xref:starters:helloworld:about.adoc[HelloWorld] and xref:starters:simpleapp:about.adoc[SimpleApp] starter apps
|===
diff --git a/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts-older.adoc b/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts-older.adoc
index 6a06040..7151322 100644
--- a/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts-older.adoc
+++ b/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts-older.adoc
@@ -80,7 +80,7 @@ Learn more xref:toc:devguide:about.adoc#intellij[here]
|Commands and Auditing (v1.6.0) +
-_Configuring the command and auditing add-on modules for the link:https://github.com/apache/isis-app-simpleapp[SimpleApp]._ +
+_Configuring the command and auditing add-on modules for the xref:starters:simpleapp:about.adoc[SimpleApp]._ +
Learn more at the (non-ASF) link:https://platform.incode.org[Incode Platform^]'s command and audit SPI modules
@@ -89,7 +89,7 @@ Learn more at the (non-ASF) link:https://platform.incode.org[Incode Platform^]'s
|Security (v1.6.0) +
-_Configuring the security add-on module for for the link:https://github.com/apache/isis-app-simpleapp[SimpleApp]._ +
+_Configuring the security add-on module for for the xref:starters:simpleapp:about.adoc[SimpleApp]._ +
Learn more at the (non-ASF) link:https://platform.incode.org[Incode Platform^]'s security SPI module.
diff --git a/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc b/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc
index c84beee..2b8c86e 100644
--- a/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc
+++ b/antora/toc/modules/ROOT/pages/what-is-apache-isis/screencasts.adoc
@@ -47,7 +47,7 @@ include::screencasts/playlists.adoc[]
//|link:https://www.youtube.com/watch?v=OTNHR5EdAs8[001^] +
-//Generating an app using the link:https://github.com/apache/isis-app-simpleapp[SimpleApp archetype]
+//Generating an app using the xref:starters:simpleapp:about.adoc[SimpleApp archetype]
//
//|x||||||||||
diff --git a/antora/toc/modules/comguide/pages/verifying-releases.adoc b/antora/toc/modules/comguide/pages/verifying-releases.adoc
index f3528e3..794dc1e 100644
--- a/antora/toc/modules/comguide/pages/verifying-releases.adoc
+++ b/antora/toc/modules/comguide/pages/verifying-releases.adoc
@@ -110,7 +110,7 @@ Alternatively, you can xref:toc:comguide:verifying-releases.adoc#casting-a-vote[
== (Optional) Verifying binary artifacts
-You can verify the binary releases by configuring your local Maven install to point to the Maven staging repository (or repositories) and then using them, eg to run the link:https://github.com/apache/isis-app-helloworld[HelloWorld starter app] or the link:https://github.com/apache/isis-app-simpleapp[SimpleApp starter app] (adjust the parent version if required).
+You can verify the binary releases by configuring your local Maven install to point to the Maven staging repository (or repositories) and then using them, eg to run the xref:starters:helloworld:about.adoc[HelloWorld starter app] or the xref:starters:simpleapp:about.adoc[SimpleApp starter app] (adjust the parent version if required).
Configuring your local Maven install amounts to updating the `~/.m2/settings.xml` file:
diff --git a/antora/toc/modules/devguide/pages/hints-and-tips/datanucleus-enhancer.adoc b/antora/toc/modules/devguide/pages/hints-and-tips/datanucleus-enhancer.adoc
index 84b3649..c3e1900 100644
--- a/antora/toc/modules/devguide/pages/hints-and-tips/datanucleus-enhancer.adoc
+++ b/antora/toc/modules/devguide/pages/hints-and-tips/datanucleus-enhancer.adoc
@@ -18,7 +18,7 @@ What this means is that the enhancer -- available as both a Maven plugin and as
If working from the Maven command line, JDO enhancement is done using the `datanucleus-maven-plugin`.
-Both the link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps have this plugin pre-configured.
+Both the xref:starters:helloworld:about.adoc[HelloWorld] and xref:starters:simpleapp:about.adoc[SimpleApp] starter apps have this plugin pre-configured.
@@ -39,7 +39,7 @@ It's also a good idea to ensure that every domain module(s) containing entities
----
<1> change as required; typically is the name of the domain module.
-Again, the link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link:https://github.com/apache/isis-app-simpleapp[Simpleapp] starter apps do this.
+Again, the xref:starters:helloworld:about.adoc[HelloWorld] and xref:starters:simpleapp:about.adoc[Simpleapp] starter apps do this.
[WARNING]
diff --git a/antora/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc b/antora/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc
index 19f2aa0..e96b159 100644
--- a/antora/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc
+++ b/antora/toc/modules/devguide/pages/hints-and-tips/how-run-fixtures-on-app-startup.adoc
@@ -13,7 +13,7 @@ Use events?_
The standard approach is to use xref:fixtures:ROOT:about.adoc[fixture scripts].
-These can be run in on start-up typically by being specified in the xref:refguide:applib-cm:classes/AppManifest-bootstrapping.adoc[`AppManifest`], see for example the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app.
+These can be run in on start-up typically by being specified in the xref:refguide:applib-cm:classes/AppManifest-bootstrapping.adoc[`AppManifest`], see for example the xref:starters:simpleapp:about.adoc[SimpleApp] starter app.
Alternatively just set `isis.fixtures` and `isis.persistor.datanucleus.install-fixtures` properties.
diff --git a/antora/toc/modules/devguide/pages/ide/eclipse.adoc b/antora/toc/modules/devguide/pages/ide/eclipse.adoc
index 98aaf5c..591417a 100644
--- a/antora/toc/modules/devguide/pages/ide/eclipse.adoc
+++ b/antora/toc/modules/devguide/pages/ide/eclipse.adoc
@@ -31,7 +31,7 @@ To install, download each XML file, then go to `Windows > Preferences > Java > E
== Install Project Lombok
-The link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app uses link:http://projectlombok.org[Project Lombok] annotations (`@Getter` and `@Setter` and so on) to reduce the boilerplate.
+The xref:starters:simpleapp:about.adoc[SimpleApp] starter app uses link:http://projectlombok.org[Project Lombok] annotations (`@Getter` and `@Setter` and so on) to reduce the boilerplate.
For Eclipse IDE this requires an link:https://projectlombok.org/setup/eclipse[installation step]:
* Locate the `lombok.jar` jar file:
@@ -107,7 +107,7 @@ DataNucleus' enhancer uses the domain object model's own classpath to reference
So, even though your domain objects are unlikely to depend on DataNucleus, these references must still be present.
See the section in xref:toc:devguide:hints-and-tips/datanucleus-enhancer.adoc[DataNucleus enhancer] for details of the contents of the `pom.xml`.
-If you've based your app on either the link:https://github.com/apache/isis-app-helloworld[HelloWorld] or the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app, then it'll be set up already.
+If you've based your app on either the xref:starters:helloworld:about.adoc[HelloWorld] or the xref:starters:simpleapp:about.adoc[SimpleApp] starter app, then it'll be set up already.
Then, tell DataNucleus to use the project classpath:
diff --git a/api/adoc/userguide/modules/btb/pages/i18n.adoc b/api/adoc/userguide/modules/btb/pages/i18n.adoc
index a5a9608..14f29ef 100644
--- a/api/adoc/userguide/modules/btb/pages/i18n.adoc
+++ b/api/adoc/userguide/modules/btb/pages/i18n.adoc
@@ -119,7 +119,7 @@ Moreover, these messages must be captured in the `.pot` file such that they can
The first part of the puzzle is tackled by an extension to Apache Isis' programming model.
Whereas previously the `disableXxx()` / `validateXxx()` / `title()` methods could only return a `java.lang.String`, they may now optionally return a `TranslatableString` (defined in Isis applib) instead.
-Here's a (silly) example from the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app:
+Here's a (silly) example from the xref:starters:simpleapp:about.adoc[SimpleApp] starter app:
[source,java]
----
diff --git a/api/adoc/userguide/modules/fun/pages/about.adoc b/api/adoc/userguide/modules/fun/pages/about.adoc
index 393af3a..ff32fa0 100644
--- a/api/adoc/userguide/modules/fun/pages/about.adoc
+++ b/api/adoc/userguide/modules/fun/pages/about.adoc
@@ -1,7 +1,7 @@
= Fundamentals
: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 [...]
-This guide introduces the xref:userguide:fun:core-concepts.adoc[core concepts] and the xref:userguide:fun:building-blocks.adoc[building blocks] of Apache Isis, and tells you how to get started with the link:https://github.com/apache/isis-app-helloworld[helloworld starter app].
+This guide introduces the xref:userguide:fun:core-concepts.adoc[core concepts] and the xref:userguide:fun:building-blocks.adoc[building blocks] of Apache Isis, and tells you how to get started with the xref:starters:helloworld:about.adoc[HelloWorld] starter app.
It describes in some detail the conventions of Apache Isis' xref:userguide:fun:programming-model.adoc[programming model]s, describes how to influence the xref:vw:ROOT:layout.adoc[UI layout] of your domain objects , and it catalogues various xref:toc:devguide:hints-and-tips.adoc.adoc[FAQ]s.
diff --git a/api/adoc/userguide/modules/fun/pages/core-concepts/philosophy/how-eases-ddd.adoc b/api/adoc/userguide/modules/fun/pages/core-concepts/philosophy/how-eases-ddd.adoc
index a6645ef..e0b361b 100644
--- a/api/adoc/userguide/modules/fun/pages/core-concepts/philosophy/how-eases-ddd.adoc
+++ b/api/adoc/userguide/modules/fun/pages/core-concepts/philosophy/how-eases-ddd.adoc
@@ -53,7 +53,7 @@ If we are using code as the primary means of expressing the model, then we need
We could generate UML diagrams and the like from code. That will work for some members of the business community, but not for everyone. Or we could generate a PDF document from Javadoc comments, but comments aren't code and so the document may be inaccurate. Anyway, even if we do create such a document, not everyone will read it.
A better way to represent the model is to show it in action as a working prototype.
-As we show in the link:https://github.com/apache/isis-app-helloworld[Getting Started] section, Apache Isis enables this with ease. Such prototypes bring the domain model to life, engaging the audience in a way that a piece of paper never can.
+As we show in the xref:starters:helloworld:about.adoc[Getting Started] section, Apache Isis enables this with ease. Such prototypes bring the domain model to life, engaging the audience in a way that a piece of paper never can.
Moreover, with Apache Isis prototypes, the domain model will come shining through. If there are mistakes or misunderstandings in the domain model (inevitable when building any complex system), they will be obvious to all.
diff --git a/api/adoc/userguide/modules/fun/pages/programming-model/properties.adoc b/api/adoc/userguide/modules/fun/pages/programming-model/properties.adoc
index dbbac98..0e37c89 100644
--- a/api/adoc/userguide/modules/fun/pages/programming-model/properties.adoc
+++ b/api/adoc/userguide/modules/fun/pages/programming-model/properties.adoc
@@ -25,7 +25,7 @@ It's also possible (using annotations) to define a link table to hold foreign ke
Apache Isis recognises some of these annotations for JDO/DataNucleus and JAXB and infers some domain semantics from them (for example, the maximum allowable length of a string property).
Since writing getter and setter methods adds quite a bit of boilerplate, it's common to use link:https://projectlombok.org/[Project Lombok] to code generate these methods at compile time (using Java's annotation processor) simply by adding the `@lombok.Getter` and `@lombok.Setter` annotations to the field.
-The link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app uses this approach.
+The xref:starters:simpleapp:about.adoc[SimpleApp] starter app uses this approach.
== Value vs Reference Types
diff --git a/api/applib/src/main/adoc/modules/applib-cm/pages/classes/AppManifest-bootstrapping.adoc b/api/applib/src/main/adoc/modules/applib-cm/pages/classes/AppManifest-bootstrapping.adoc
index beec4ad..92290ad 100644
--- a/api/applib/src/main/adoc/modules/applib-cm/pages/classes/AppManifest-bootstrapping.adoc
+++ b/api/applib/src/main/adoc/modules/applib-cm/pages/classes/AppManifest-bootstrapping.adoc
@@ -233,7 +233,7 @@ Moreover, these classes recognise that configuration properties fall into two br
* those that change between environments. +
+ The classic example here is the JDBC URL.
-For example, the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app's `AppManifest` is defined as:
+For example, the xref:starters:simpleapp:about.adoc[SimpleApp] starter app's `AppManifest` is defined as:
[source,java]
----
diff --git a/api/applib/src/main/adoc/modules/applib-svc/pages/testing/FixtureScriptsSpecificationProvider.adoc b/api/applib/src/main/adoc/modules/applib-svc/pages/testing/FixtureScriptsSpecificationProvider.adoc
index 212214f..36e9463 100644
--- a/api/applib/src/main/adoc/modules/applib-svc/pages/testing/FixtureScriptsSpecificationProvider.adoc
+++ b/api/applib/src/main/adoc/modules/applib-svc/pages/testing/FixtureScriptsSpecificationProvider.adoc
@@ -45,7 +45,7 @@ The class is immutable but it has a builder (obtained using `FixturescriptsSpeci
== Implementation
-The link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app has a simple implementation of this service:
+The xref:starters:simpleapp:about.adoc[SimpleApp] starter app has a simple implementation of this service:
[source,java]
----
diff --git a/core/config/src/main/adoc/modules/config/pages/specifying-components.adoc b/core/config/src/main/adoc/modules/config/pages/specifying-components.adoc
index 3bae498..95ef43a 100644
--- a/core/config/src/main/adoc/modules/config/pages/specifying-components.adoc
+++ b/core/config/src/main/adoc/modules/config/pages/specifying-components.adoc
@@ -28,7 +28,7 @@ To specify the `AppManifest` as a configuration property, use:
|`o.a.i.applib.AppManifest` +
By convention this implementation resides in an `myapp-app` Maven module (as opposed to `myapp-dom` or `myapp-fixture`).
-See the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app for details.
+See the xref:starters:simpleapp:about.adoc[SimpleApp] starter app for details.
|===
diff --git a/extensions/core/flyway/adoc/modules/flyway/pages/about.adoc b/extensions/core/flyway/adoc/modules/flyway/pages/about.adoc
index c720bd3..841b529 100644
--- a/extensions/core/flyway/adoc/modules/flyway/pages/about.adoc
+++ b/extensions/core/flyway/adoc/modules/flyway/pages/about.adoc
@@ -61,7 +61,7 @@ If you want your tests to check your Flyway scripts beforehand, there is nothing
One point to be aware of though is that the DDL syntax may vary between an in-memory database (such as H2) and a typical production database (such as PostgreSQL or SQL Server).
Luckily, Spring Boot's Flyway integration allows different variants of scripts for different vendors to be stored, in `+db.migration.{vendor}+` package (where `+{vendor}+` is as defined by the https://github.com/spring-projects/spring-boot/blob/v2.2.3.RELEASE/spring-boot-project/spring-boot/src/main/java/org/springframework/boot/jdbc/DatabaseDriver.java[DatabaseDriver] class).
-The link:https://github.com/apache/isis-app-simpleapp[simpleapp starter app] also provides an example of this.
+The xref:starters:simpleapp:about.adoc[simpleapp starter app] also provides an example of this.
=== Custom schemas
diff --git a/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/intro.adoc b/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/intro.adoc
index 4f07956..0f71927 100644
--- a/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/intro.adoc
+++ b/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/intro.adoc
@@ -38,7 +38,7 @@ As noted in the introduction, all the goals require an xref:refguide:applib-cm:c
This can be extremely minimal; it isn't necessary to use the main `AppManifest` (in the `app` module) used to bootstrap the application, you can instead use a cut-down one.
This then allows the plugins to be run during the build of the `dom` module, rather than having to run in the context of the `integtest` module.
-For example, the link:https://github.com/apache/isis-app-simpleapp[SimpleApp]'s
+For example, the xref:starters:simpleapp:about.adoc[SimpleApp]'s
manifest is:
[source,java]
diff --git a/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/validate.adoc b/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/validate.adoc
index 66367e9..61b4b77 100644
--- a/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/validate.adoc
+++ b/legacy/testing/mavenplugin/src/main/doc/modules/mvn/pages/validate.adoc
@@ -105,7 +105,7 @@ mvn test -Dskip.isis-validate
== Example of failure
-In the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] application the `SimpleObject` defines an `updateName` action.
+In the xref:starters:simpleapp:about.adoc[SimpleApp] application the `SimpleObject` defines an `updateName` action.
This has a supporting method:
diff --git a/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/disabling-persistence-by-reachability.adoc b/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/disabling-persistence-by-reachability.adoc
index d21c4bb..f0eeaf7 100644
--- a/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/disabling-persistence-by-reachability.adoc
+++ b/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/disabling-persistence-by-reachability.adoc
@@ -26,7 +26,7 @@ We therefore recommend that you disable persistence-by-reachability by adding th
isis.persistor.datanucleus.impl.datanucleus.persistenceByReachabilityAtCommit=false
----
-This change has been made to both the link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps.
+This change has been made to both the xref:starters:helloworld:about.adoc[HelloWorld] and xref:starters:simpleapp:about.adoc[SimpleApp] starter apps.
If you do disable this feature, then you will (of course) need to ensure that you explicitly persist all entities using the `RepositoryService#persist(.)` or `RepositoryService#persistAndFlush(.)` methods.
diff --git a/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/persistence-xml.adoc b/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/persistence-xml.adoc
index f553ea5..b584357 100644
--- a/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/persistence-xml.adoc
+++ b/persistence/jdo/src/main/adoc/modules/ROOT/pages/configuring/persistence-xml.adoc
@@ -8,7 +8,7 @@ DataNucleus will for itself also and read the `META-INF/persistence.xml`.
In theory it can hold mappings and even connection strings.
However, with Apache Isis we tend to use annotations instead and externalize connection strings. so its definition is extremely simply, specifying just the name of the "persistence unit".
-Here's the one provided by the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app:
+Here's the one provided by the xref:starters:simpleapp:about.adoc[SimpleApp] starter app:
[source,xml]
----
diff --git a/security/adoc/modules/ROOT/pages/about.adoc b/security/adoc/modules/ROOT/pages/about.adoc
index c42d4fa..cea5263 100644
--- a/security/adoc/modules/ROOT/pages/about.adoc
+++ b/security/adoc/modules/ROOT/pages/about.adoc
@@ -32,7 +32,7 @@ Shiro in turn uses the concept of a _realm_ as a source for both authentication
WARNING: TODO: v2: Spring Boot requires that shiro.ini is on classpath, not in WEB-INF.
Shiro ships with a simple text-based realm -- the `IniRealm` -- which reads users (and password), user roles and role permissions from the `WEB-INF/shiro.ini` file.
-The link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps are both configured to use this realm.
+The xref:starters:helloworld:about.adoc[HelloWorld] and xref:starters:simpleapp:about.adoc[SimpleApp] starter apps are both configured to use this realm.
Shiro also ships with an implementation of an LDAP-based realm; LDAP is often used to manage user/passwords and corresponding user groups.
Apache Isis in turn extends this with its `IsisLdapRealm`, which provides more flexibility for both group/role and role/permissions management.
diff --git a/security/shiro/src/main/adoc/modules/shiro/pages/about/configuring-isis-to-use-shiro.adoc b/security/shiro/src/main/adoc/modules/shiro/pages/about/configuring-isis-to-use-shiro.adoc
index 657f186..cb383fd 100644
--- a/security/shiro/src/main/adoc/modules/shiro/pages/about/configuring-isis-to-use-shiro.adoc
+++ b/security/shiro/src/main/adoc/modules/shiro/pages/about/configuring-isis-to-use-shiro.adoc
@@ -9,7 +9,7 @@ The Shiro security mechanism is an integration wih Apache Shiro that implements
[TIP]
====
-Both the link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps are pre-configured to use Apache Shiro, so much of what follows may well have been set up already.
+Both the xref:starters:helloworld:about.adoc[HelloWorld] and xref:starters:simpleapp:about.adoc[SimpleApp] starter apps are pre-configured to use Apache Shiro, so much of what follows may well have been set up already.
====
@@ -17,7 +17,7 @@ Both the link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link
To tell Apache Isis to use Shiro when using an xref:refguide:applib-cm:rgcms.adoc#__rgcms_classes_AppManifest-bootstrapping_bootstrapping_AppManifestAbstract[`AppManifestAbstract.BUILDER`], simply specify the "authMechanism" as "shiro".
-For example, the link:https://github.com/apache/isis-app-helloworld[HelloWorld] starter app bootstraps using:
+For example, the xref:starters:helloworld:about.adoc[HelloWorld] starter app bootstraps using:
// TODO: v2: this is out of date.
diff --git a/security/shiro/src/main/adoc/modules/shiro/pages/about/ini-realm.adoc b/security/shiro/src/main/adoc/modules/shiro/pages/about/ini-realm.adoc
index 0493fa7..54c8da2 100644
--- a/security/shiro/src/main/adoc/modules/shiro/pages/about/ini-realm.adoc
+++ b/security/shiro/src/main/adoc/modules/shiro/pages/about/ini-realm.adoc
@@ -10,7 +10,7 @@ Probably the simplest realm to use is Shiro's built-in `IniRealm`, which reads f
This is suitable for prototyping, but isn't intended for production use, if only because user/password credentials are stored in plain text.
Nevertheless, it's a good starting point.
-The app generated by both the link:https://github.com/apache/isis-app-helloworld[HelloWorld] and link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps are configured to use this realm.
+The app generated by both the xref:starters:helloworld:about.adoc[HelloWorld] and xref:starters:simpleapp:about.adoc[SimpleApp] starter apps are configured to use this realm.
The diagram below shows the Isis and components involved:
diff --git a/testing/fixtures/adoc/modules/fixtures/pages/fixture-scripts/api-and-usage.adoc b/testing/fixtures/adoc/modules/fixtures/pages/fixture-scripts/api-and-usage.adoc
index 169caa6..0e910e6 100644
--- a/testing/fixtures/adoc/modules/fixtures/pages/fixture-scripts/api-and-usage.adoc
+++ b/testing/fixtures/adoc/modules/fixtures/pages/fixture-scripts/api-and-usage.adoc
@@ -18,7 +18,7 @@ This is annotated to be rendered on the secondary "Prototyping" menu.
The behaviour of this domain menu service can be refined by providing an implementation of the optional xref:refguide:applib-svc:testing/FixtureScriptsSpecificationProvider.adoc[`FixtureScriptsSpecificationProvider`] SPI.
-For example, here's the `FixtureScriptsSpecificationProvider` service that's generated by the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter apps:
+For example, here's the `FixtureScriptsSpecificationProvider` service that's generated by the xref:starters:simpleapp:about.adoc[SimpleApp] starter apps:
[source,java]
----
@@ -69,7 +69,7 @@ If you had defined many fixture scripts then a drop-down might become unwieldy,
----
-You are free, of course, to add additional "convenience" actions into it if you wish for the most commonly used/demo'd setups ; you'll find that the link:https://github.com/apache/isis-app-simpleapp[SimpleApp archetype] adds this additional action:
+You are free, of course, to add additional "convenience" actions into it if you wish for the most commonly used/demo'd setups ; you'll find that the xref:starters:simpleapp:about.adoc[SimpleApp archetype] adds this additional action:
[source,java]
----
@@ -95,7 +95,7 @@ However, we strongly recommend that you use it to invoke actions on business obj
That way, the fixture script will remain valid even if the underlying implementation of the system changes in the future.
For example, here's a fixture script called `RecreateSimpleObjects`.
-(This used to be part of the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app, though it now has a more sophisticated design, discussed below):
+(This used to be part of the xref:starters:simpleapp:about.adoc[SimpleApp] starter app, though it now has a more sophisticated design, discussed below):
[source,java]
----
@@ -161,7 +161,7 @@ So, in this case, when the fixture script is executed we actually get 6 objects
Fixture scripts can be called from integration tests just the same way that fixture scripts can call one another.
-For example, here's an integration test from the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app:
+For example, here's an integration test from the xref:starters:simpleapp:about.adoc[SimpleApp] starter app:
// TODO: v2: this will be out of date, no doubt.
@@ -243,7 +243,7 @@ public interface PersonaWithFinder<T> {
}
----
-The link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app provides a sample implementation of these interfaces:
+The xref:starters:simpleapp:about.adoc[SimpleApp] starter app provides a sample implementation of these interfaces:
[source,java]
----
diff --git a/viewers/restfulobjects/adoc/modules/ROOT/pages/layout-resources.adoc b/viewers/restfulobjects/adoc/modules/ROOT/pages/layout-resources.adoc
index 5ee4482..4af4243 100644
--- a/viewers/restfulobjects/adoc/modules/ROOT/pages/layout-resources.adoc
+++ b/viewers/restfulobjects/adoc/modules/ROOT/pages/layout-resources.adoc
@@ -12,7 +12,7 @@ This chapter provides details of these resources, the link ``Rel``s to access th
The xref:refguide:applib-svc:presentation-layer-spi/MenuBarsService.adoc[`MenuBarsService`] provides the `menu.layout.xml` XML document which defines how to group the various domain service actions into menubars, menus and menu sections.
-For example, the link:https://github.com/apache/isis-app-helloworld[Hello World starter app] has the following layout:
+For example, the xref:starters:helloworld:about.adoc[Hello World starter app] has the following layout:
[source,xml]
----
@@ -134,7 +134,7 @@ Note that because of dynamic icons (the xref:refguide:applib-cm:methods.adoc#ico
The xref:refguide:applib-svc:presentation-layer-spi/GridService.adoc[`GridService`] provides an XML document which defines the layout of any of domain object.
Typically this is the contents of the `Xxx.layout.xml` file (where `Xxx` is the domain type).
-For example, in the link:https://github.com/apache/isis-app-helloworld[Hello World starter app] the `HelloWorld` domain object has a layout defined by `HelloWorld.layout.xml`.
+For example, in the xref:starters:helloworld:about.adoc[Hello World starter app] the `HelloWorld` domain object has a layout defined by `HelloWorld.layout.xml`.
The representation returned by the domain object resource (section 14.4 of the RO spec v1.0) has been extended to provide a link to this resource:
diff --git a/viewers/wicket/adoc/modules/ROOT/pages/layout/file-based.adoc b/viewers/wicket/adoc/modules/ROOT/pages/layout/file-based.adoc
index ee6580c..b2b3e1b 100644
--- a/viewers/wicket/adoc/modules/ROOT/pages/layout/file-based.adoc
+++ b/viewers/wicket/adoc/modules/ROOT/pages/layout/file-based.adoc
@@ -458,7 +458,7 @@ Ensure the following is defined in the dom project's `pom.xml`:
</resources>
----
-If using an Apache Isis link:https://github.com/apache/isis-app-helloworld[HelloWorld] link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app, then the POM is already correctly configured.
+If using an Apache Isis xref:starters:helloworld:about.adoc[HelloWorld] xref:starters:simpleapp:about.adoc[SimpleApp] starter app, then the POM is already correctly configured.
diff --git a/viewers/wicket/adoc/modules/ROOT/pages/menubars-layout/file-based.adoc b/viewers/wicket/adoc/modules/ROOT/pages/menubars-layout/file-based.adoc
index a2eedfe..61c33c6 100644
--- a/viewers/wicket/adoc/modules/ROOT/pages/menubars-layout/file-based.adoc
+++ b/viewers/wicket/adoc/modules/ROOT/pages/menubars-layout/file-based.adoc
@@ -37,7 +37,7 @@ image::/menubars/020-download.png[width="400px",link="{imagesdir}/menubars/020-d
The "Default" layout is that currently in use, while the "Fallback" layout is that provided only from the annotations.
Initially these are identical.
-For example, here's a fragment of that provided by the link:https://github.com/apache/isis-app-simpleapp[SimpleApp] starter app:
+For example, here's a fragment of that provided by the xref:starters:simpleapp:about.adoc[SimpleApp] starter app:
[source,xml]
----