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 2016/04/05 13:38:48 UTC

[1/4] isis git commit: ISIS-1335: adding some more screencasts.

Repository: isis
Updated Branches:
  refs/heads/master 253d48fc0 -> 879c5454e


ISIS-1335: adding some more screencasts.


Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/5b9fa776
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/5b9fa776
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/5b9fa776

Branch: refs/heads/master
Commit: 5b9fa7768dddce405cc1870bb485d835db60c01c
Parents: 253d48f
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Sat Apr 2 11:08:42 2016 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Sat Apr 2 11:08:42 2016 +0100

----------------------------------------------------------------------
 .../src/main/asciidoc/screencasts.adoc          | 38 ++++++++++++++++++++
 1 file changed, 38 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis/blob/5b9fa776/adocs/documentation/src/main/asciidoc/screencasts.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/screencasts.adoc b/adocs/documentation/src/main/asciidoc/screencasts.adoc
index e0d4f94..9d27f71 100644
--- a/adocs/documentation/src/main/asciidoc/screencasts.adoc
+++ b/adocs/documentation/src/main/asciidoc/screencasts.adoc
@@ -344,6 +344,44 @@ You can also find some earlier screencasts (for older versions of the framework)
 |===
 
 
+== Action validation
+
+[cols="2a,2a"]
+|===
+
+
+|How to validate action parameters using a supporting xref:rgcms.adoc#_rgcms_methods_prefixes_validate[`validateNXxx()`] method. +
+(v1.12.0)
+
+|video::ORoEYlg6XFM[youtube,width="560px",height="315px"]
+
+
+
+|How to validate action parameters using the xref:rgant.adoc#_rgant_Parameter_mustSatisfy[`@Parameter#mustSatisfy()`]  and the Specification interface..  +
+(v1.12.0)
+
+|video::1Vlzob89pYI[youtube,width="560px",height="315px"]
+
+|===
+
+
+
+== Instantiating/Initializing Objects
+
+[cols="2a,2a"]
+|===
+
+
+|How to instantiate/initialize objects using xref:rgsvc.adoc#_rgsvc_api_RepositoryService[`RepositoryService`], xref:rgsvc.adoc#_rgsvc_api_ServiceRegistry[`ServiceRegistry`] and/or xref:rgsvc.adoc#_rgsvc_api_FactoryService[`FactoryService`]. +
+(v1.12.0)
+
+|video::fYJjXAepWAs[youtube,width="560px",height="315px"]
+
+
+
+|===
+
+
 
 
 == Older screencasts


[3/4] isis git commit: ISIS-1335: adding some further screencasts

Posted by da...@apache.org.
ISIS-1335: adding some further screencasts


Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/b6e2d7bf
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/b6e2d7bf
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/b6e2d7bf

Branch: refs/heads/master
Commit: b6e2d7bf1f83060c98ab2f0d8d51d98e3a07b505
Parents: d7797be
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Apr 5 11:04:59 2016 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Apr 5 11:42:52 2016 +0100

----------------------------------------------------------------------
 adocs/documentation/pom.xml                     | 62 ++++++++-------
 .../src/main/asciidoc/screencasts.adoc          | 79 ++++++++++++++++++++
 2 files changed, 112 insertions(+), 29 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis/blob/b6e2d7bf/adocs/documentation/pom.xml
----------------------------------------------------------------------
diff --git a/adocs/documentation/pom.xml b/adocs/documentation/pom.xml
index 216981c..783c7f1 100644
--- a/adocs/documentation/pom.xml
+++ b/adocs/documentation/pom.xml
@@ -53,8 +53,8 @@
 
         <build.dir>${project.basedir}/target/site</build.dir>
 
-        <isis-site.dir>${project.basedir}/../../../isis-site/content</isis-site.dir>
-        <redirects.dir>${project.basedir}/../redirects/content</redirects.dir>
+        <isis-site.dir>../../../isis-site/content</isis-site.dir>
+        <redirects.dir>../redirects/content</redirects.dir>
         <message>updating content (built from adocs/documentation in isis.git repo)</message>
     </properties>
 
@@ -420,39 +420,43 @@
             <build>
                 <plugins>
                     <plugin>
-                        <artifactId>maven-antrun-plugin</artifactId>
-                        <version>1.8</version>
+                        <groupId>org.codehaus.gmaven</groupId>
+                        <artifactId>groovy-maven-plugin</artifactId>
+                        <version>2.0</version>
                         <executions>
                             <execution>
                                 <id>install</id>
                                 <phase>install</phase>
-                                <configuration>
-                                    <target>
-                                        <echo message=""/>
-                                        <echo message=""/>
-                                        <echo message="git add all content"/>
-                                        <echo message=""/>
-                                        <exec executable="git" dir="${isis-site.dir}">
-                                            <arg value="add"/>
-                                            <arg value="--all"/>
-                                            <arg value="."/>
-                                        </exec>
-
-                                        <echo message=""/>
-                                        <echo message=""/>
-                                        <echo message="git commit -m '${message}' "/>
-                                        <echo message=""/>
-                                        <exec executable="git" dir="${isis-site.dir}">
-                                            <arg value="commit"/>
-                                            <arg value="-m"/>
-                                            <arg value="${message}"/>
-                                        </exec>
-                                        <echo message=""/>
-                                    </target>
-                                </configuration>
                                 <goals>
-                                    <goal>run</goal>
+                                    <goal>execute</goal>
                                 </goals>
+                                <configuration>
+                                    <source>
+                                        def siteDir = new File("${isis-site.dir}", "..")
+
+                                        "git add content --all".execute(null, siteDir).in.text
+                                        "git reset content/guides".execute(null, siteDir).in.text
+
+                                        def gitStatusOutput = "git status --porcelain".execute(null, siteDir).in.text
+
+                                        def lines = gitStatusOutput.readLines()
+                                        lines.each{ line ->
+                                            def file=line.drop(3)
+                                            if(file.endsWith(".html")) {
+                                                def pdfFile = file.replaceAll(".html",".pdf")
+                                                println file
+                                                "git add $file".execute(null, siteDir).in.text
+                                                println pdfFile
+                                                "git add $pdfFile".execute(null, siteDir).in.text
+                                            }
+                                        }
+
+                                        "git commit -m '${message}'".execute(null, siteDir).in.text
+                                        "git reset --hard".execute(null, siteDir).in.text
+
+                                        return null
+                                    </source>
+                                </configuration>
                             </execution>
                         </executions>
                     </plugin>

http://git-wip-us.apache.org/repos/asf/isis/blob/b6e2d7bf/adocs/documentation/src/main/asciidoc/screencasts.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/screencasts.adoc b/adocs/documentation/src/main/asciidoc/screencasts.adoc
index 9d27f71..76229e9 100644
--- a/adocs/documentation/src/main/asciidoc/screencasts.adoc
+++ b/adocs/documentation/src/main/asciidoc/screencasts.adoc
@@ -377,6 +377,85 @@ You can also find some earlier screencasts (for older versions of the framework)
 
 |video::fYJjXAepWAs[youtube,width="560px",height="315px"]
 
+|===
+
+
+
+== Property and parameter choices
+
+[cols="2a,2a"]
+|===
+
+
+|How to provide a set of xref:rgcms.adoc#_rgcms_methods_prefixes_choices[choices] (a drop-down list) when editing a property. +
+(v1.12.0)
+
+|video::cQ06PoMNDPw[youtube,width="560px",height="315px"]
+
+
+|How to provide a set of xref:rgcms.adoc#_rgcms_methods_prefixes_choices[choices] (a drop-down list) when invoking an action. +
+(v1.12.0)
+
+|video::afEnYKljBQs[youtube,width="560px",height="315px"]
+
+
+|How to use the xref:rgcms.adoc#_rgcms_methods_prefixes_choices[choices] supporting methods as a source for default values within a xref:ugtst.adoc#_ugtst_fixture-scripts[fixture script]. +
+(v1.12.0)
+
+|video::fKo6aTPK-gk[youtube,width="560px",height="315px"]
+
+
+|How to use an enum for choices (drop down list) for both a property or an action parameter. +
+(v1.12.0)
+
+|video::ZWOzmwCJVzA[youtube,width="560px",height="315px"]
+
+
+
+|===
+
+
+
+== Hiding columns
+
+[cols="2a,2a"]
+|===
+
+
+|How to hide properties as columns in tables (parented collections or standalone collections), using the dynamic XML layout (equivalent to xref:rgant.adoc#_rgant_PropertyLayout_hidden[`@PropertyLayout#hidden()`]) . +
+(v1.12.0)
+
+|video::1SCyBlMM2Bo[youtube,width="560px",height="315px"]
+
+
+|How to hide properties as columns in tables, using CSS. +
+(v1.12.0)
+
+|video::H11yby1Xkbc[youtube,width="560px",height="315px"]
+
+
+
+|===
+
+
+
+== Fixture scripts defaults / fake data
+
+[cols="2a,2a"]
+|===
+
+
+|Using the xref:rgcms.adoc#_rgcms_classes_super_FixtureScript[`FixtureScript`] `defaultParam(...)` method to reflectively default parameters to fixture scripts that have not been set by the caller. +
+(v1.12.0)
+
+|video::NKaR7ZedI8E[youtube,width="560px",height="315px"]
+
+
+
+|Using the (non-ASF) http://github.com/isisaddons/isis-module-fakedata[Isis addons' fakedata] module's `FakeDataService` to provide fake (random) names within a fixture script. +
+(v1.12.0)
+
+|video::-jMiD9n1L5U[youtube,width="560px",height="315px"]
 
 
 |===


[2/4] isis git commit: ISIS-1335: replacing use of video:xxx in guides with links to youtube (because former can't be rendered in PDF format).

Posted by da...@apache.org.
ISIS-1335: replacing use of video:xxx in guides with links to youtube (because former can't be rendered in PDF format).

Also, minor improvement to asciidoc pom.xml: use mvn package -Dskip.pdf to just rebuild html without doing a full clean; can then selectively add/commit individual pages of website more easily.


Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/d7797be1
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/d7797be1
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/d7797be1

Branch: refs/heads/master
Commit: d7797be1b634fe9d0e5b6aae3ee6e811260723c6
Parents: 5b9fa77
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Sun Apr 3 16:01:51 2016 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Sun Apr 3 16:01:51 2016 +0100

----------------------------------------------------------------------
 adocs/documentation/pom.xml                     | 37 +++++++++++++++++---
 .../asciidoc/guides/_dg_asciidoc-templates.adoc |  2 +-
 .../main/asciidoc/guides/_dg_ide_eclipse.adoc   |  4 +--
 .../guides/_rgcms_classes_utility_Enums.adoc    | 13 +++++++
 .../guides/_rgsvc_api_CommandContext.adoc       |  3 +-
 .../guides/_rgsvc_spi_CommandService.adoc       |  5 +--
 ...ncepts_philosophy_naked-objects-pattern.adoc |  4 +--
 .../_ugfun_object-layout_dynamic_xml.adoc       |  3 +-
 .../asciidoc/guides/_ugvro_hints-and-tips.adoc  |  3 +-
 .../main/asciidoc/guides/_ugvro_ro-spec.adoc    |  5 ++-
 .../_ugvro_simplified-representations.adoc      |  3 +-
 11 files changed, 57 insertions(+), 25 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/pom.xml
----------------------------------------------------------------------
diff --git a/adocs/documentation/pom.xml b/adocs/documentation/pom.xml
index bd46ce2..216981c 100644
--- a/adocs/documentation/pom.xml
+++ b/adocs/documentation/pom.xml
@@ -243,10 +243,10 @@
         </profile>
 
         <profile>
-            <id>copy</id>
+            <id>delete</id>
             <activation>
                 <property>
-                    <name>!skip.copy</name>
+                    <name>!skip.delete</name>
                 </property>
             </activation>
             <build>
@@ -256,8 +256,8 @@
                         <version>1.8</version>
                         <executions>
                             <execution>
-                                <id>package</id>
-                                <phase>package</phase>
+                                <id>clean</id>
+                                <phase>clean</phase>
                                 <configuration>
                                     <target>
                                         <echo message=""/>
@@ -267,7 +267,36 @@
                                         <delete includeemptydirs="true">
                                             <fileset dir="${isis-site.dir}" includes="**/*"/>
                                         </delete>
+                                    </target>
+                                </configuration>
+                                <goals>
+                                    <goal>run</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
 
+        <profile>
+            <id>copy</id>
+            <activation>
+                <property>
+                    <name>!skip.copy</name>
+                </property>
+            </activation>
+            <build>
+                <plugins>
+                    <plugin>
+                        <artifactId>maven-antrun-plugin</artifactId>
+                        <version>1.8</version>
+                        <executions>
+                            <execution>
+                                <id>package</id>
+                                <phase>package</phase>
+                                <configuration>
+                                    <target>
                                         <echo message=""/>
                                         <echo message=""/>
                                         <echo message="copying from ${redirects.dir} to ${isis-site.dir}"/>

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_dg_asciidoc-templates.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_dg_asciidoc-templates.adoc b/adocs/documentation/src/main/asciidoc/guides/_dg_asciidoc-templates.adoc
index 485b390..652c94a 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_dg_asciidoc-templates.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_dg_asciidoc-templates.adoc
@@ -596,7 +596,7 @@ embeds image from specified URL, where:
 
 == YouTube (screencasts)
 
-Embedded youtube screencasts
+Embedded youtube screencasts.  (Don't use these in guides, as they cannot be rendered as PDF).
 
 [cols="1,4a,2a", options="header"]
 |===

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_dg_ide_eclipse.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_dg_ide_eclipse.adoc b/adocs/documentation/src/main/asciidoc/guides/_dg_ide_eclipse.adoc
index 6cf8e87..7a20b2f 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_dg_ide_eclipse.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_dg_ide_eclipse.adoc
@@ -26,9 +26,9 @@ This plugin needs to be configured for each of your domain modules (usually just
 
 == Screencast
 
-The following screencast shows how to import an Apache Isis maven-based application into Eclipse and configure to use with the JDO Objectstore
+This link:https://www.youtube.com/watch?v=RgcYfjQ8yJA[screencast] shows how to import an Apache Isis maven-based
+application into Eclipse and configure to use with the JDO Objectstore.
 
-video::RgcYfjQ8yJA[youtube,width="640px",height="480px"]
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_utility_Enums.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_utility_Enums.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_utility_Enums.adoc
index fa688ae..3f43c6b 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_utility_Enums.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgcms_classes_utility_Enums.adoc
@@ -6,3 +6,16 @@
 
 
 NOTE: TODO
+
+[source,java]
+----
+public final class Enums {
+    public static String getFriendlyNameOf(Enum<?> anEnum) { ... }
+    public static String getFriendlyNameOf(String anEnumName) { ... }
+    public static String getEnumNameFromFriendly(String anEnumFriendlyName) { ... }
+    public static String enumToHttpHeader(final Enum<?> anEnum) { ... }
+    public static String enumNameToHttpHeader(final String name) { ... }
+    public static String enumToCamelCase(final Enum<?> anEnum) { ... }
+}
+----
+

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
index 138221d..23a5a41 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_api_CommandContext.adoc
@@ -26,9 +26,8 @@ Assuming that the `CommandService` supports persistent `Command`s, the associate
 == Screencast
 
 
-The screencast provides a run-through of the command (profiling) service, auditing service, publishing service. It also shows how commands can be run in the background either explicitly by scheduling through the background service or implicitly by way of a framework annotation.
+The link:https://www.youtube.com/watch?v=tqXUZkPB3EI[screencast] provides a run-through of the command (profiling) service, auditing service, publishing service. It also shows how commands can be run in the background either explicitly by scheduling through the background service or implicitly by way of a framework annotation.
 
-video::tqXUZkPB3EI[youtube,width="640px",height="360px"]
 
 [NOTE]
 ====

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
index 4aa78d9..1777d4d 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_rgsvc_spi_CommandService.adoc
@@ -18,12 +18,9 @@ Persistent `Command`s support several use cases:
 
 
 
-The screencast below provides a run-through of the command (profiling) service, auditing service, publishing service. It also shows how commands can be run in the background either explicitly by scheduling through the background service or implicitly by way of a framework annotation.
+This link:https://www.youtube.com/watch?v=tqXUZkPB3EI[screencast] below provides a run-through of the command (profiling) service, auditing service, publishing service. It also shows how commands can be run in the background either explicitly by scheduling through the background service or implicitly by way of a framework annotation.
 
 
-
-video::tqXUZkPB3EI[youtube,width="560px",height="315px"]
-
 [NOTE]
 ====
 Note that this screencast shows an earlier version of the xref:ugvw.adoc#[Wicket viewer] UI (specifically, pre 1.8.0).

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_philosophy_naked-objects-pattern.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_philosophy_naked-objects-pattern.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_philosophy_naked-objects-pattern.adoc
index fbe13f1..1c1b63d 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_philosophy_naked-objects-pattern.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_core-concepts_philosophy_naked-objects-pattern.adoc
@@ -47,10 +47,8 @@ include::_ugfun_core-concepts_philosophy_naked-objects-pattern_object-interface-
 
 == What this means in practice
 
-The screencast below shows what all of this means in practice, showing the relationship between a running app and the actual code underneath.
+This link:https://www.youtube.com/watch?v=ludOLyi6VyY[screencast] shows what all of this means in practice, showing the relationship between a running app and the actual code underneath.
 
-.How Apache Isis builds a webapp from the underlying domain object model…
-video::ludOLyi6VyY[youtube,width="640px",height="472px"]
 
 [NOTE]
 ====

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_ugfun_object-layout_dynamic_xml.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugfun_object-layout_dynamic_xml.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugfun_object-layout_dynamic_xml.adoc
index df080c2..9a97f41 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugfun_object-layout_dynamic_xml.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugfun_object-layout_dynamic_xml.adoc
@@ -33,9 +33,8 @@ More information about these classes can be found in xref:rgcms.adoc#_rgcms_clas
 
 == Screencast
 
-The following screencast describes the feature:
+This link:https://www.youtube.com/watch?v=MxewC5Pve5k[screencast] describes the feature.
 
-video::MxewC5Pve5k[youtube,width="800px",height="534px"]
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc
index 14498bc..4436e52 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvro_hints-and-tips.adoc
@@ -15,9 +15,8 @@ This section provides a few hints-and-tips to help you on your way.
 
 == Using Chrome Tools
 
-The screencast below shows how to explore the Restful API using Chrome plugins/extensions, and how we use them to write end-2-end (TCK) tests for the Restful Objects viewer.
+This link:https://www.youtube.com/watch?v=_-TOvVYWCHc[screencast] shows how to explore the Restful API using Chrome plugins/extensions, and how we use them to write end-2-end (TCK) tests for the Restful Objects viewer.
 
-video::_-TOvVYWCHc[youtube,width="840px",height="472px"]
 
 
 

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc
index 95f6bb3..43c3358 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvro_ro-spec.adoc
@@ -157,13 +157,12 @@ in the RO spec, the main point being to avoid the "N+1" problem of too many (slo
 this feature one can load a grid of data in a single call.  (That said, the xref:ugvro.adoc#_ugvro_simplified-representations[simplified representations]
 supported by Restful Objects viewer also support this use case, albeit in way that deviates from the RO spec).
 
-The video below demonstrates the Restful Object viewer's support for `x-ro-follow-links` parameter, using the
+This link:https://www.youtube.com/watch?v=hSKnqqBQ7Zo[screencast] demonstrates the Restful Object viewer's support for `x-ro-follow-links` parameter, using the
 (non-ASF) http://github.com/isisaddons/isis-app-kitchensink[Isis addons' kitchensink] app as the example,
 This app contains three entities, `Grandparent`, `Parent` and `Child` that define a hierarchy of 1:m relationships.
 
-video::hSKnqqBQ7Zo[youtube,width="840px",height="472px"]
 
-The queries that are shown in the video include:
+The queries that are shown in the screencast include:
 
 * show parent and its children (titles) +
 +

http://git-wip-us.apache.org/repos/asf/isis/blob/d7797be1/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
index c215f71..c1f3ddf 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_ugvro_simplified-representations.adoc
@@ -44,9 +44,8 @@ Accept: application/json;profile="urn:org.apache.isis/v1"
 Not every resource supports this header, but the most commonly accessed ones do.  In each case the server will set the
 `Content-Type` header so that the client knows how to process the representation.
 
-The screencast below demonstrates the feature.
+The link:https://www.youtube.com/watch?v=HMSqapQDY_4[screencast] demonstrates the feature.
 
-video::HMSqapQDY_4[youtube,width="853px",height="480px"]
 
 
 The sections below explain in a little more detail what is returned when this profile is activated.


[4/4] isis git commit: ISIS-1335: improvements to documentation pom.xml, don't commit the PDFs if no change

Posted by da...@apache.org.
ISIS-1335: improvements to documentation pom.xml, don't commit the PDFs if no change


Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/879c5454
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/879c5454
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/879c5454

Branch: refs/heads/master
Commit: 879c5454e309a42348d56dcd3f7c0287a559732c
Parents: b6e2d7b
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Tue Apr 5 12:37:55 2016 +0100
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Tue Apr 5 12:37:55 2016 +0100

----------------------------------------------------------------------
 adocs/documentation/pom.xml | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/isis/blob/879c5454/adocs/documentation/pom.xml
----------------------------------------------------------------------
diff --git a/adocs/documentation/pom.xml b/adocs/documentation/pom.xml
index 783c7f1..13df594 100644
--- a/adocs/documentation/pom.xml
+++ b/adocs/documentation/pom.xml
@@ -444,15 +444,16 @@
                                             def file=line.drop(3)
                                             if(file.endsWith(".html")) {
                                                 def pdfFile = file.replaceAll(".html",".pdf")
-                                                println file
                                                 "git add $file".execute(null, siteDir).in.text
-                                                println pdfFile
                                                 "git add $pdfFile".execute(null, siteDir).in.text
                                             }
                                         }
 
-                                        "git commit -m '${message}'".execute(null, siteDir).in.text
-                                        "git reset --hard".execute(null, siteDir).in.text
+                                        // doesn't seem to do anything :-(
+                                        "git commit --message '${message}'".execute(null, siteDir).text
+
+                                        // and so, commenting this out.
+                                        // println "git reset --hard".execute(null, siteDir).in.text
 
                                         return null
                                     </source>