You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@causeway.apache.org by da...@apache.org on 2023/05/18 13:17:24 UTC

[causeway] 07/17: CAUSEWAY-2485 : updates markdown value type samples in demo app

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/causeway.git

commit c8398c1fe313cd5132a1f220558e1892b856f54f
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Thu May 18 10:20:06 2023 +0100

    CAUSEWAY-2485 : updates markdown value type samples in demo app
---
 .../markdowns/CausewayMarkdowns-common.adoc           |  4 +---
 .../markdowns/CausewayMarkdowns-description.adoc      | 12 ++++++------
 .../causewayval/markdowns/CausewayMarkdowns.java      | 13 +++++++------
 .../markdowns/CausewayMarkdowns.layout.xml            |  2 --
 .../markdowns/holder/CausewayMarkdownHolder.java      | 19 ++++++++++---------
 .../markdowns/holder/CausewayMarkdownHolder2.java     | 10 +++++-----
 .../CausewayMarkdownHolder_actionReturning.java       |  5 +++--
 ...sewayMarkdownHolder_actionReturningCollection.java |  7 ++++---
 .../holder/CausewayMarkdownHolder_mixinProperty.java  |  5 +++--
 ...MarkdownHolder_updateReadOnlyOptionalProperty.java |  7 ++++---
 ...der_updateReadOnlyOptionalPropertyWithChoices.java | 11 ++++++-----
 ...CausewayMarkdownHolder_updateReadOnlyProperty.java |  7 ++++---
 ...kdownHolder_updateReadOnlyPropertyWithChoices.java | 11 ++++++-----
 .../jdo/CausewayMarkdownJdo-description.adoc          |  4 +---
 .../markdowns/jdo/CausewayMarkdownJdo.java            | 15 ++++++++-------
 .../markdowns/jdo/CausewayMarkdownJdoEntities.java    |  7 ++++---
 .../jpa/CausewayMarkdownJpa-description.adoc          |  4 +---
 .../markdowns/jpa/CausewayMarkdownJpa.java            | 15 ++++++++-------
 .../markdowns/jpa/CausewayMarkdownJpaEntities.java    |  7 ++++---
 .../markdowns/persistence/CausewayMarkdownEntity.java |  7 ++++---
 .../persistence/CausewayMarkdownEntity.layout.xml     |  2 --
 .../persistence/CausewayMarkdownSeeding.java          |  5 +++--
 .../markdowns/vm/CausewayMarkdownVm-description.adoc  |  4 +---
 .../causewayval/markdowns/vm/CausewayMarkdownVm.java  | 15 ++++++++-------
 .../markdowns/vm/CausewayMarkdownVm.layout.xml        |  2 --
 25 files changed, 101 insertions(+), 99 deletions(-)

diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-common.adoc b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-common.adoc
index b414d5b55d..7f9a276f08 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-common.adoc
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-common.adoc
@@ -1,10 +1,8 @@
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-// // This file was GENERATED by the showcase generator (tooling). Do NOT edit!
-
 == Mixin actions
 
-A number of mixin actions contribute through the `CausewayMarkdownHolder` interface, demonstrate the use of `org.apache.causeway.valuetypes.markdown.applib.value.Markdown` as a parameter and as a return type.
+A number of mixin actions contribute through the `CausewayMarkdownHolder` interface, demonstrate the use of `Markdown` as a parameter and as a return type.
 For example:
 
 * the `updateReadOnlyProperty` action is:
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-description.adoc b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-description.adoc
index 74b8ef0aa9..53486730c2 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-description.adoc
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns-description.adoc
@@ -1,14 +1,14 @@
 :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 file was GENERATED by the showcase generator (tooling). Do NOT edit!
-
-The framework has built-in support for the `org.apache.causeway.valuetypes.markdown.applib.value.Markdown` data type.
+The framework has built-in support for HTML markup, written in Markdown, using the `Markdown` data type.
 These can be used either in entities or view models.
 
+NOTE: This is an Apache Causeway specific data type.
+
 == How this demo works
 
-On the left hand side is a collection of entities that uses the `org.apache.causeway.valuetypes.markdown.applib.value.Markdown` datatype.
-There is also an action that opens a view model; this view model also uses the `org.apache.causeway.valuetypes.markdown.applib.value.Markdown` datatype.
+On the left hand side is a collection of entities that uses the `Markdown` datatype.
+There is also an action that opens a view model; this view model also uses the `Markdown` datatype.
 
 Navigate into the entity or view model to see the datatype used as a property, an action parameter and as a return type of collections, along with code samples.
 
@@ -25,4 +25,4 @@ include::holder/CausewayMarkdownHolder.java[tags=class]
 
 * The `CausewayMarkdownHolder2` interface is used to demonstrate support for label positions using `@PropertyLayout(labelPosition=...)`.
 
-
+Further details, along with the effect of this annotation, can be seen on the entity and view model object pages.
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.java
index 926287c606..8ea3430244 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.java
@@ -39,13 +39,14 @@ import org.apache.causeway.applib.annotation.ObjectSupport;
 import org.apache.causeway.applib.annotation.PromptStyle;
 import org.apache.causeway.applib.annotation.SemanticsOf;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import demoapp.dom._infra.asciidocdesc.HasAsciiDocDescription;
 import demoapp.dom._infra.values.ValueHolderRepository;
 import demoapp.dom.types.Samples;
 import demoapp.dom.types.causewayval.markdowns.persistence.CausewayMarkdownEntity;
 import demoapp.dom.types.causewayval.markdowns.vm.CausewayMarkdownVm;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 @XmlRootElement(name = "Demo")
 @XmlType
 @XmlAccessorType(XmlAccessType.FIELD)
@@ -55,15 +56,15 @@ import demoapp.dom.types.causewayval.markdowns.vm.CausewayMarkdownVm;
 public class CausewayMarkdowns implements HasAsciiDocDescription {
 
     @ObjectSupport public String title() {
-        return "org.apache.causeway.valuetypes.markdown.applib.value.Markdown data type";
+        return "Markdown data type";
     }
 
     @Action(semantics = SemanticsOf.SAFE)
     @ActionLayout(promptStyle = PromptStyle.DIALOG_MODAL)
-    public CausewayMarkdownVm openViewModel(final org.apache.causeway.valuetypes.markdown.applib.value.Markdown initialValue) {
+    public CausewayMarkdownVm openViewModel(final Markdown initialValue) {
         return new CausewayMarkdownVm(initialValue);
     }
-    @MemberSupport public org.apache.causeway.valuetypes.markdown.applib.value.Markdown default0OpenViewModel() {
+    @MemberSupport public Markdown default0OpenViewModel() {
         return samples.single();
     }
 
@@ -74,10 +75,10 @@ public class CausewayMarkdowns implements HasAsciiDocDescription {
 
     @Inject
     @XmlTransient
-    ValueHolderRepository<org.apache.causeway.valuetypes.markdown.applib.value.Markdown, ? extends CausewayMarkdownEntity> entities;
+    ValueHolderRepository<Markdown, ? extends CausewayMarkdownEntity> entities;
 
     @Inject
     @XmlTransient
-    Samples<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> samples;
+    Samples<Markdown> samples;
 
 }
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.layout.xml b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.layout.xml
index b37e7b6cb1..671874816c 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.layout.xml
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/CausewayMarkdowns.layout.xml
@@ -15,8 +15,6 @@
         xmlns:cpt="https://causeway.apache.org/applib/layout/component"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
-	<!-- This file was GENERATED by the showcase generator (tooling). Do NOT edit! -->
-
 	<bs3:row>
 		<bs3:col span="10" unreferencedActions="true">
 			<cpt:domainObject />
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder.java
index 22db831d32..2263c7027a 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder.java
@@ -20,22 +20,23 @@ package demoapp.dom.types.causewayval.markdowns.holder;
 
 import javax.inject.Named;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 @Named("demo.CausewayMarkdownHolder")
 //tag::class[]
 public interface CausewayMarkdownHolder {
 
-    org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadOnlyProperty();
-    void setReadOnlyProperty(org.apache.causeway.valuetypes.markdown.applib.value.Markdown c);
+    Markdown getReadOnlyProperty();
+    void setReadOnlyProperty(Markdown c);
 
-    org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadWriteProperty();
-    void setReadWriteProperty(org.apache.causeway.valuetypes.markdown.applib.value.Markdown c);
+    Markdown getReadWriteProperty();
+    void setReadWriteProperty(Markdown c);
 
-    org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadOnlyOptionalProperty();
-    void setReadOnlyOptionalProperty(org.apache.causeway.valuetypes.markdown.applib.value.Markdown c);
+    Markdown getReadOnlyOptionalProperty();
+    void setReadOnlyOptionalProperty(Markdown c);
 
-    org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadWriteOptionalProperty();
-    void setReadWriteOptionalProperty(org.apache.causeway.valuetypes.markdown.applib.value.Markdown c);
+    Markdown getReadWriteOptionalProperty();
+    void setReadWriteOptionalProperty(Markdown c);
 
 }
 //end::class[]
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder2.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder2.java
index a9bbdcb412..d1fcb6f23e 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder2.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder2.java
@@ -22,8 +22,8 @@ import org.apache.causeway.applib.annotation.LabelPosition;
 import org.apache.causeway.applib.annotation.Property;
 import org.apache.causeway.applib.annotation.PropertyLayout;
 import org.apache.causeway.applib.annotation.Where;
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 public interface CausewayMarkdownHolder2 extends CausewayMarkdownHolder {
 
@@ -34,7 +34,7 @@ public interface CausewayMarkdownHolder2 extends CausewayMarkdownHolder {
             "@PropertyLayout(labelPosition=LEFT)",
         hidden = Where.ALL_TABLES,
         fieldSetId = "label-positions", sequence = "1")     // <.>
-    default org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadOnlyPropertyDerivedLabelPositionLeft() {
+    default Markdown getReadOnlyPropertyDerivedLabelPositionLeft() {
         return getReadOnlyProperty();
     }
 
@@ -45,7 +45,7 @@ public interface CausewayMarkdownHolder2 extends CausewayMarkdownHolder {
             "@PropertyLayout(labelPosition=TOP)",
         hidden = Where.ALL_TABLES,
         fieldSetId = "label-positions", sequence = "2")
-    default org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadOnlyPropertyDerivedLabelPositionTop() {
+    default Markdown getReadOnlyPropertyDerivedLabelPositionTop() {
         return getReadOnlyProperty();
     }
 
@@ -56,7 +56,7 @@ public interface CausewayMarkdownHolder2 extends CausewayMarkdownHolder {
             "@PropertyLayout(labelPosition=RIGHT)",
         hidden = Where.ALL_TABLES,
         fieldSetId = "label-positions", sequence = "3")
-    default org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadOnlyPropertyDerivedLabelPositionRight() {
+    default Markdown getReadOnlyPropertyDerivedLabelPositionRight() {
         return getReadOnlyProperty();
     }
 
@@ -67,7 +67,7 @@ public interface CausewayMarkdownHolder2 extends CausewayMarkdownHolder {
             "@PropertyLayout(labelPosition=NONE)",
         hidden = Where.ALL_TABLES,
         fieldSetId = "label-positions", sequence = "4")
-    default org.apache.causeway.valuetypes.markdown.applib.value.Markdown getReadOnlyPropertyDerivedLabelPositionNone() {
+    default Markdown getReadOnlyPropertyDerivedLabelPositionNone() {
         return getReadOnlyProperty();
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturning.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturning.java
index f1e69b655b..4146d6910b 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturning.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturning.java
@@ -21,9 +21,10 @@ package demoapp.dom.types.causewayval.markdowns.holder;
 import org.apache.causeway.applib.annotation.Action;
 import org.apache.causeway.applib.annotation.SemanticsOf;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.RequiredArgsConstructor;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @Action(semantics = SemanticsOf.SAFE)
 @RequiredArgsConstructor
@@ -31,7 +32,7 @@ public class CausewayMarkdownHolder_actionReturning {
 
     private final CausewayMarkdownHolder holder;
 
-    public org.apache.causeway.valuetypes.markdown.applib.value.Markdown act() {
+    public Markdown act() {
         return holder.getReadOnlyProperty();
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturningCollection.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturningCollection.java
index 8b8c76a0ce..d8af418430 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturningCollection.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_actionReturningCollection.java
@@ -26,11 +26,12 @@ import javax.inject.Inject;
 import org.apache.causeway.applib.annotation.Action;
 import org.apache.causeway.applib.annotation.SemanticsOf;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.RequiredArgsConstructor;
 
 import demoapp.dom.types.Samples;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @Action(semantics = SemanticsOf.SAFE)
 @RequiredArgsConstructor
@@ -38,13 +39,13 @@ public class CausewayMarkdownHolder_actionReturningCollection {
 
     private final CausewayMarkdownHolder holder;
 
-    public Collection<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> act() {
+    public Collection<Markdown> act() {
         return samples.stream()
                 .collect(Collectors.toList());
     }
 
     @Inject
-    Samples<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> samples;
+    Samples<Markdown> samples;
 
 }
 //end::class[]
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_mixinProperty.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_mixinProperty.java
index 9a67ddd9e0..eded09529c 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_mixinProperty.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_mixinProperty.java
@@ -22,9 +22,10 @@ import org.apache.causeway.applib.annotation.Property;
 import org.apache.causeway.applib.annotation.PropertyLayout;
 import org.apache.causeway.applib.annotation.Where;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.RequiredArgsConstructor;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @Property()
 @PropertyLayout(hidden = Where.ALL_TABLES, fieldSetId = "contributed", sequence = "1")
@@ -33,7 +34,7 @@ public class CausewayMarkdownHolder_mixinProperty {
 
     private final CausewayMarkdownHolder holder;
 
-    public org.apache.causeway.valuetypes.markdown.applib.value.Markdown prop() {
+    public Markdown prop() {
         return holder.getReadOnlyProperty();
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalProperty.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalProperty.java
index b646bd4d6a..c5e6560085 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalProperty.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalProperty.java
@@ -26,9 +26,10 @@ import org.apache.causeway.applib.annotation.Parameter;
 import org.apache.causeway.applib.annotation.PromptStyle;
 import org.apache.causeway.applib.annotation.SemanticsOf;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.RequiredArgsConstructor;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @Action(
         semantics = SemanticsOf.IDEMPOTENT
@@ -45,13 +46,13 @@ public class CausewayMarkdownHolder_updateReadOnlyOptionalProperty {
 
     @MemberSupport public CausewayMarkdownHolder act(
             @Parameter(optionality = Optionality.OPTIONAL)              // <.>
-            final org.apache.causeway.valuetypes.markdown.applib.value.Markdown newValue
+            final Markdown newValue
     ) {
         holder.setReadOnlyOptionalProperty(newValue);
         return holder;
     }
 
-    @MemberSupport public org.apache.causeway.valuetypes.markdown.applib.value.Markdown default0Act() {
+    @MemberSupport public Markdown default0Act() {
         return holder.getReadOnlyOptionalProperty();
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalPropertyWithChoices.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalPropertyWithChoices.java
index a16559b79a..78d98d69ad 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalPropertyWithChoices.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyOptionalPropertyWithChoices.java
@@ -31,11 +31,12 @@ import org.apache.causeway.applib.annotation.Parameter;
 import org.apache.causeway.applib.annotation.PromptStyle;
 import org.apache.causeway.applib.annotation.SemanticsOf;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.RequiredArgsConstructor;
 
 import demoapp.dom.types.Samples;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @Action(
         semantics = SemanticsOf.IDEMPOTENT
@@ -52,21 +53,21 @@ public class CausewayMarkdownHolder_updateReadOnlyOptionalPropertyWithChoices {
 
     @MemberSupport public CausewayMarkdownHolder act(
             @Parameter(optionality = Optionality.OPTIONAL)
-            final org.apache.causeway.valuetypes.markdown.applib.value.Markdown newValue) {
+            final Markdown newValue) {
         holder.setReadOnlyOptionalProperty(newValue);
         return holder;
     }
 
-    @MemberSupport public org.apache.causeway.valuetypes.markdown.applib.value.Markdown default0Act() {
+    @MemberSupport public Markdown default0Act() {
         return holder.getReadOnlyOptionalProperty();
     }
 
-    @MemberSupport public List<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> choices0Act() {
+    @MemberSupport public List<Markdown> choices0Act() {
         return samples.stream()
                 .collect(Collectors.toList());
     }
 
     @Inject
-    Samples<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> samples;
+    Samples<Markdown> samples;
 }
 //end::class[]
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyProperty.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyProperty.java
index f4163ce311..84ba22539c 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyProperty.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyProperty.java
@@ -24,9 +24,10 @@ import org.apache.causeway.applib.annotation.MemberSupport;
 import org.apache.causeway.applib.annotation.PromptStyle;
 import org.apache.causeway.applib.annotation.SemanticsOf;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.RequiredArgsConstructor;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @Action(
         semantics = SemanticsOf.IDEMPOTENT
@@ -41,12 +42,12 @@ public class CausewayMarkdownHolder_updateReadOnlyProperty {
 
     private final CausewayMarkdownHolder holder;
 
-    @MemberSupport public CausewayMarkdownHolder act(final org.apache.causeway.valuetypes.markdown.applib.value.Markdown newValue) {
+    @MemberSupport public CausewayMarkdownHolder act(final Markdown newValue) {
         holder.setReadOnlyProperty(newValue);
         return holder;
     }
 
-    @MemberSupport public org.apache.causeway.valuetypes.markdown.applib.value.Markdown default0Act() {
+    @MemberSupport public Markdown default0Act() {
         return holder.getReadOnlyProperty();
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyPropertyWithChoices.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyPropertyWithChoices.java
index 8cebaadbcf..d0fb58facc 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyPropertyWithChoices.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/holder/CausewayMarkdownHolder_updateReadOnlyPropertyWithChoices.java
@@ -29,11 +29,12 @@ import org.apache.causeway.applib.annotation.MemberSupport;
 import org.apache.causeway.applib.annotation.PromptStyle;
 import org.apache.causeway.applib.annotation.SemanticsOf;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.RequiredArgsConstructor;
 
 import demoapp.dom.types.Samples;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @Action(
         semantics = SemanticsOf.IDEMPOTENT
@@ -48,22 +49,22 @@ public class CausewayMarkdownHolder_updateReadOnlyPropertyWithChoices {
 
     private final CausewayMarkdownHolder holder;
 
-    @MemberSupport public CausewayMarkdownHolder act(final org.apache.causeway.valuetypes.markdown.applib.value.Markdown newValue) {
+    @MemberSupport public CausewayMarkdownHolder act(final Markdown newValue) {
         holder.setReadOnlyProperty(newValue);
         return holder;
     }
 
-    @MemberSupport public org.apache.causeway.valuetypes.markdown.applib.value.Markdown default0Act() {
+    @MemberSupport public Markdown default0Act() {
         return holder.getReadOnlyProperty();
     }
 
-    @MemberSupport public List<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> choices0Act() {
+    @MemberSupport public List<Markdown> choices0Act() {
         return samples.stream()
                 .collect(Collectors.toList());
     }
 
     @Inject
-    Samples<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> samples;
+    Samples<Markdown> samples;
 
 }
 //end::class[]
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo-description.adoc b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo-description.adoc
index 6edf42926a..41108eefe6 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo-description.adoc
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo-description.adoc
@@ -1,8 +1,6 @@
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-// // This file was GENERATED by the showcase generator (tooling). Do NOT edit!
-
-JDO supports `org.apache.causeway.valuetypes.markdown.applib.value.Markdown` out-of-the-box, so no special annotations are required.
+Apache Causeway provides its own implementation of the relevant JDO extension points for the `Markdown` value type, meaning that JDO can persist properties of this value type without further configuration.
 
 [source,java]
 ----
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo.java
index 54c6c3deea..d82ff478dd 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdo.java
@@ -35,12 +35,13 @@ import org.apache.causeway.applib.annotation.PropertyLayout;
 import org.apache.causeway.applib.annotation.Title;
 import org.apache.causeway.applib.annotation.Where;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.Getter;
 import lombok.Setter;
 
 import demoapp.dom.types.causewayval.markdowns.persistence.CausewayMarkdownEntity;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 @Profile("demo-jdo")
 //tag::class[]
 @PersistenceCapable(identityType = IdentityType.DATASTORE, schema = "demo")
@@ -51,35 +52,35 @@ public class CausewayMarkdownJdo                                          // <.>
         extends CausewayMarkdownEntity {
 
 //end::class[]
-    public CausewayMarkdownJdo(final org.apache.causeway.valuetypes.markdown.applib.value.Markdown initialValue) {
+    public CausewayMarkdownJdo(final Markdown initialValue) {
         this.readOnlyProperty = initialValue;
         this.readWriteProperty = initialValue;
     }
 
 //tag::class[]
-    @Title(prepend = "org.apache.causeway.valuetypes.markdown.applib.value.Markdown JDO entity: ")
+    @Title(prepend = "Markdown JDO entity: ")
     @PropertyLayout(fieldSetId = "read-only-properties", sequence = "1")
     @Column(allowsNull = "false", jdbcType = "CLOB")                            // <.>
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readOnlyProperty;
+    private Markdown readOnlyProperty;
 
     @Property(editing = Editing.ENABLED)                                        // <.>
     @PropertyLayout(fieldSetId = "editable-properties", sequence = "1", hidden = Where.ALL_TABLES, multiLine = 5)
     @Column(allowsNull = "false", jdbcType = "CLOB")
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readWriteProperty;
+    private Markdown readWriteProperty;
 
     @Property(optionality = Optionality.OPTIONAL)                               // <.>
     @PropertyLayout(fieldSetId = "optional-properties", sequence = "1")
     @Column(allowsNull = "true", jdbcType = "CLOB")                             // <.>
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readOnlyOptionalProperty;
+    private Markdown readOnlyOptionalProperty;
 
     @Property(editing = Editing.ENABLED, optionality = Optionality.OPTIONAL)
     @PropertyLayout(fieldSetId = "optional-properties", sequence = "2", hidden = Where.ALL_TABLES, multiLine = 5)
     @Column(allowsNull = "true", jdbcType = "CLOB")
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readWriteOptionalProperty;
+    private Markdown readWriteOptionalProperty;
 
 }
 //end::class[]
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdoEntities.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdoEntities.java
index 26f0783d42..4422f1eaf7 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdoEntities.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jdo/CausewayMarkdownJdoEntities.java
@@ -21,20 +21,21 @@ package demoapp.dom.types.causewayval.markdowns.jdo;
 import org.springframework.context.annotation.Profile;
 import org.springframework.stereotype.Service;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import demoapp.dom._infra.values.ValueHolderRepository;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 @Profile("demo-jdo")
 @Service
 public class CausewayMarkdownJdoEntities
-extends ValueHolderRepository<org.apache.causeway.valuetypes.markdown.applib.value.Markdown, CausewayMarkdownJdo> {
+extends ValueHolderRepository<Markdown, CausewayMarkdownJdo> {
 
     protected CausewayMarkdownJdoEntities() {
         super(CausewayMarkdownJdo.class);
     }
 
     @Override
-    protected CausewayMarkdownJdo newDetachedEntity(org.apache.causeway.valuetypes.markdown.applib.value.Markdown value) {
+    protected CausewayMarkdownJdo newDetachedEntity(Markdown value) {
         return new CausewayMarkdownJdo(value);
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa-description.adoc b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa-description.adoc
index 7adf212043..f3eac32ce6 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa-description.adoc
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa-description.adoc
@@ -1,8 +1,6 @@
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-// // This file was GENERATED by the showcase generator (tooling). Do NOT edit!
-
-JPA supports `org.apache.causeway.valuetypes.markdown.applib.value.Markdown` out-of-the-box, so no special annotations are required.
+Apache Causeway provides its own implementation of the relevant JPA extension points for the `Markdown` value type, meaning that JPA can persist properties of this value type without further configuration.
 
 [source,java]
 ----
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa.java
index 88cccaa01f..12d54a9c29 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpa.java
@@ -40,13 +40,14 @@ import org.apache.causeway.applib.annotation.Title;
 import org.apache.causeway.applib.annotation.Where;
 import org.apache.causeway.persistence.jpa.applib.integration.CausewayEntityListener;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 import lombok.Setter;
 
 import demoapp.dom.types.causewayval.markdowns.persistence.CausewayMarkdownEntity;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 @Profile("demo-jpa")
 //tag::class[]
 @Entity
@@ -62,7 +63,7 @@ public class CausewayMarkdownJpa
         extends CausewayMarkdownEntity {
 
 //end::class[]
-    public CausewayMarkdownJpa(final org.apache.causeway.valuetypes.markdown.applib.value.Markdown initialValue) {
+    public CausewayMarkdownJpa(final Markdown initialValue) {
         this.readOnlyProperty = initialValue;
         this.readWriteProperty = initialValue;
     }
@@ -72,29 +73,29 @@ public class CausewayMarkdownJpa
     @GeneratedValue
     private Long id;
 
-    @Title(prepend = "org.apache.causeway.valuetypes.markdown.applib.value.Markdown JPA entity: ")
+    @Title(prepend = "Markdown JPA entity: ")
     @PropertyLayout(fieldSetId = "read-only-properties", sequence = "1")
     @Column(nullable = false) @Lob @Basic(fetch=FetchType.LAZY)                 // <.>
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readOnlyProperty;
+    private Markdown readOnlyProperty;
 
     @Property(editing = Editing.ENABLED)                                        // <.>
     @PropertyLayout(fieldSetId = "editable-properties", sequence = "1", hidden = Where.ALL_TABLES, multiLine = 5)
     @Column(nullable = false) @Lob @Basic(fetch=FetchType.LAZY)
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readWriteProperty;
+    private Markdown readWriteProperty;
 
     @Property(optionality = Optionality.OPTIONAL)                               // <.>
     @PropertyLayout(fieldSetId = "optional-properties", sequence = "1")
     @Column(nullable = true) @Lob @Basic(fetch=FetchType.LAZY)                  // <.>
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readOnlyOptionalProperty;
+    private Markdown readOnlyOptionalProperty;
 
     @Property(editing = Editing.ENABLED, optionality = Optionality.OPTIONAL)
     @PropertyLayout(fieldSetId = "optional-properties", sequence = "2", hidden = Where.ALL_TABLES, multiLine = 5)
     @Column(nullable = true) @Lob @Basic(fetch=FetchType.LAZY)
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readWriteOptionalProperty;
+    private Markdown readWriteOptionalProperty;
 
 }
 //end::class[]
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpaEntities.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpaEntities.java
index 90dc3265be..59fc22e5fa 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpaEntities.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/jpa/CausewayMarkdownJpaEntities.java
@@ -21,20 +21,21 @@ package demoapp.dom.types.causewayval.markdowns.jpa;
 import org.springframework.context.annotation.Profile;
 import org.springframework.stereotype.Service;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import demoapp.dom._infra.values.ValueHolderRepository;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 @Profile("demo-jpa")
 @Service
 public class CausewayMarkdownJpaEntities
-extends ValueHolderRepository<org.apache.causeway.valuetypes.markdown.applib.value.Markdown, CausewayMarkdownJpa> {
+extends ValueHolderRepository<Markdown, CausewayMarkdownJpa> {
 
     protected CausewayMarkdownJpaEntities() {
         super(CausewayMarkdownJpa.class);
     }
 
     @Override
-    protected CausewayMarkdownJpa newDetachedEntity(org.apache.causeway.valuetypes.markdown.applib.value.Markdown value) {
+    protected CausewayMarkdownJpa newDetachedEntity(Markdown value) {
         return new CausewayMarkdownJpa(value);
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.java
index de00c3cc5b..337db4e56c 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.java
@@ -26,17 +26,18 @@ import demoapp.dom._infra.asciidocdesc.HasAsciiDocDescription;
 import demoapp.dom._infra.values.ValueHolder;
 import demoapp.dom.types.causewayval.markdowns.holder.CausewayMarkdownHolder2;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 @Named("demo.CausewayMarkdownEntity") // shared permissions with concrete sub class
 @DomainObject
 public abstract class CausewayMarkdownEntity
 implements
     HasAsciiDocDescription,
     CausewayMarkdownHolder2,
-    ValueHolder<org.apache.causeway.valuetypes.markdown.applib.value.Markdown> {
+    ValueHolder<Markdown> {
 
     @Override
-    public org.apache.causeway.valuetypes.markdown.applib.value.Markdown value() {
+    public Markdown value() {
         return getReadOnlyProperty();
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.layout.xml b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.layout.xml
index c68675bab8..e126ed4493 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.layout.xml
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownEntity.layout.xml
@@ -15,8 +15,6 @@
         xmlns:cpt="https://causeway.apache.org/applib/layout/component"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
-	<!-- This file was GENERATED by the showcase generator (tooling). Do NOT edit! -->
-
 	<bs3:row>
 		<bs3:col span="10" unreferencedActions="true">
 			<cpt:domainObject />
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownSeeding.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownSeeding.java
index 509322d5e3..416fbf278a 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownSeeding.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/persistence/CausewayMarkdownSeeding.java
@@ -22,16 +22,17 @@ import javax.inject.Inject;
 
 import org.springframework.stereotype.Service;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import demoapp.dom._infra.seed.SeedServiceAbstract;
 import demoapp.dom._infra.values.ValueHolderRepository;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 @Service
 public class CausewayMarkdownSeeding
 extends SeedServiceAbstract {
 
     @Inject
-    public CausewayMarkdownSeeding(ValueHolderRepository<org.apache.causeway.valuetypes.markdown.applib.value.Markdown, ? extends CausewayMarkdownEntity> entities) {
+    public CausewayMarkdownSeeding(ValueHolderRepository<Markdown, ? extends CausewayMarkdownEntity> entities) {
         super(entities);
     }
 
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm-description.adoc b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm-description.adoc
index 8b33f62857..36026def1f 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm-description.adoc
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm-description.adoc
@@ -1,8 +1,6 @@
 :Notice: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at. http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or ag [...]
 
-// // This file was GENERATED by the showcase generator (tooling). Do NOT edit!
-
-JAXB supports `org.apache.causeway.valuetypes.markdown.applib.value.Markdown` out-of-the-box, so no special annotations are required.
+Apache Causeway provides its own implementation of `@XmlJavaTypeAdapter` for the `Markdown` value type, meaning that JAXB can serialize properties of this value type without further configuration.
 
 [source,java]
 ----
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.java b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.java
index e2eae1a6fe..37950ca890 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.java
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.java
@@ -33,13 +33,14 @@ import org.apache.causeway.applib.annotation.Property;
 import org.apache.causeway.applib.annotation.PropertyLayout;
 import org.apache.causeway.applib.annotation.Title;
 
+import org.apache.causeway.valuetypes.markdown.applib.value.Markdown;
+
 import lombok.Getter;
 import lombok.Setter;
 
 import demoapp.dom._infra.asciidocdesc.HasAsciiDocDescription;
 import demoapp.dom.types.causewayval.markdowns.holder.CausewayMarkdownHolder2;
 
-/* This file was GENERATED by the showcase generator (tooling). Do NOT edit! */
 //tag::class[]
 @XmlRootElement(name = "root")
 @XmlType
@@ -52,33 +53,33 @@ public class CausewayMarkdownVm
         implements HasAsciiDocDescription, CausewayMarkdownHolder2 {
 
 //end::class[]
-    public CausewayMarkdownVm(final org.apache.causeway.valuetypes.markdown.applib.value.Markdown initialValue) {
+    public CausewayMarkdownVm(final Markdown initialValue) {
         this.readOnlyProperty = initialValue;
         this.readWriteProperty = initialValue;
     }
 
 //tag::class[]
-    @Title(prepend = "org.apache.causeway.valuetypes.markdown.applib.value.Markdown view model: ")
+    @Title(prepend = "Markdown view model: ")
     @PropertyLayout(fieldSetId = "read-only-properties", sequence = "1")
     @XmlElement(required = true)                                                // <.>
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readOnlyProperty;
+    private Markdown readOnlyProperty;
 
     @Property(editing = Editing.ENABLED)                                        // <.>
     @PropertyLayout(fieldSetId = "editable-properties", sequence = "1")
     @XmlElement(required = true)
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readWriteProperty;
+    private Markdown readWriteProperty;
 
     @Property(optionality = Optionality.OPTIONAL)                               // <.>
     @PropertyLayout(fieldSetId = "optional-properties", sequence = "1")
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readOnlyOptionalProperty;
+    private Markdown readOnlyOptionalProperty;
 
     @Property(editing = Editing.ENABLED, optionality = Optionality.OPTIONAL)
     @PropertyLayout(fieldSetId = "optional-properties", sequence = "2")
     @Getter @Setter
-    private org.apache.causeway.valuetypes.markdown.applib.value.Markdown readWriteOptionalProperty;
+    private Markdown readWriteOptionalProperty;
 
 }
 //end::class[]
diff --git a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.layout.xml b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.layout.xml
index 24d8ceabbb..1df6c2e346 100644
--- a/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.layout.xml
+++ b/examples/demo/domain/src/main/java/demoapp/dom/types/causewayval/markdowns/vm/CausewayMarkdownVm.layout.xml
@@ -15,8 +15,6 @@
         xmlns:cpt="https://causeway.apache.org/applib/layout/component"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 
-	<!-- This file was GENERATED by the showcase generator (tooling). Do NOT edit! -->
-
 	<bs3:row>
 		<bs3:col span="10" unreferencedActions="true">
 			<cpt:domainObject />