editorial

Author: nicholascar

shacl12-overview/index.html

@@ -25,10 +25,11 @@
 
 				editors: [
 					{
-						name: "Nicholas Car",
+						name: "Nicholas J. Car",
 						company: "KurrawongAI",
 						companyURL: "https://kurrawong.ai",
 						mailto: "[email protected]",
+						orcid: "0000-0002-8742-7730",
 						w3cid: "70131"
 					},
 					{
@@ -384,20 +385,15 @@ <h2>What's New in SHACL 1.2</h2>
 			<p class="todo">
 				The main information about SHACL 1.0 &rarr; 1.2 will be added here.
 			</p>
-			<h4>SHACL-SHACL</h4>
 			<p>
-				SHACL 1.0 included all the information about SHACL-SHACL at the time inline, within an Appendix, consisting of an
-				introductory paragraph and the SHACL-SHACL RDF data only. SHACL 1.2 has moved this information to an appendix in this Overview..
-			</p>
-			<p>
-				A note about this new SHACL-SHACL location is retained in SHACL 1.2 Core.
+				SHACL 1.0 Core <a href="https://www.w3.org/TR/2017/REC-shacl-20170720/#shacl-shacl">included an appendix</a> providing a shapes graph to be used to validate shapes graphs according to the SHACL 1.0 Core specification. SHACL 1.2 has moved this information from the Core specification to an appendix in this Overview to allow for information relevant to parts of SHACL 1.2 not in the Core. A note about this new SHACL-SHACL location is retained in SHACL 1.2 Core.
 			</p>
 		</section>
 
 		<section id="specifications">
 			<h2>Specifications</h2>
 			<h3>
-				SHACL 1.2:
+				SHACL 1.2
 			</h3>
 			<dl>
 				<dt>SHACL 1.2 Overview (this document)</dt>
@@ -417,16 +413,16 @@ <h3>
 			</dl>
 
 			<h3>
-				SHACL 1.0:
+				SHACL 1.0
 			</h3>
 			<p><em>The original SHACL specifications, now deprecated in favour of SHACL 1.2 specifications, above.</em></p>
 			<dl>
-				<dt><a href="https://www.w3.org/TR/shacl/">SHACL</a></dt>
-				<dd></dd>
-				<dt><a href="https://www.w3.org/TR/shacl-af/">SHACL Advanced Features</a></dt>
-				<dd></dd>
+				<dt><a href="https://www.w3.org/TR/2017/REC-shacl-20170720/">SHACL</a></dt>
+				<dd>the original SHACL Shapes Constraint Language definition</dd>
+				<dt><a href="https://www.w3.org/TR/2017/NOTE-shacl-af-20170608/">SHACL Advanced Features</a></dt>
+				<dd>a Working Group Note about "features to define custom targets, annotation properties, user-defined functions, node expressions and rules"</dd>
 				<dt><a href="https://www.w3.org/TR/shacl-js/">SHACL Javascript Extensions</a></dt>
-				<dd></dd>
+				<dd>a Working Group Note about JavaScript-based extension mechanism for the Shapes Constraint Language</dd>
 			</dl>
 		</section>
 
@@ -449,15 +445,29 @@ <h2>SHACL-SHACL</h2>
 				Each SHACL-SHACL graph corresponds to the scope of individual SHACL specifications and are available as RDF resources:
 			</p>
 			<dl>
-				<dt><a href="">SHACL-SHACL all</a></dt>
-				<dd>the union of all other SHACL-SHACL graphs</dd>
 				<dt><a href="">SHACL-SHACL Core</a></dt>
+				<dd>Core specification elements only</dd>
 				<dt><a href="">SHACL-SHACL SPARQL</a></dt>
+				<dd>SPARQL specification elements only</dd>
 				<dt><a href="">SHACL-SHACL Node Expressions</a></dt>
+				<dd>Node Expression specification elements only</dd>
 				<dt><a href="">SHACL-SHACL Inference Rules</a></dt>
+				<dd>Inference Rules specification elements only</dd>
 				<dt><a href="">SHACL-SHACL UI</a></dt>
+				<dd>UI specification elements only</dd>
 				<dt><a href="">SHACL-SHACL Profiling</a></dt>
+				<dd>Profiling specification elements only</dd>
+			</dl>
+			<p>
+				Additionally, the union of the above shapes graphs is also provided:
+			</p>
+			<dl>
+				<dt><a href="">SHACL-SHACL union</a></dt>
+				<dd>the union of all other SHACL-SHACL graphs</dd>
 			</dl>
+			<p>
+				The SHACL-SHACL shapes graphs listed above can be retrieved from their namespace IRIs and are also available within the <a href="https://github.com/w3c/shacl-resources">W3C SHACL Resources repository</a> which also contains other community-generated SHACL resources.
+			</p>
 		</section>
 
 		<section id="security" class="appendix informative">