What's New stub section; SHACL-SHACL stub section; section reordering

Author: nicholascar

shacl12-overview/index.html

@@ -363,23 +363,103 @@
 		<section id="introduction">
 			<h2>Introduction</h2>
 			<p>
-				This document provides a non-normative, high-level, overview of the various Shapes Constraint Language (SHACL) documents.
+				This document provides a non-normative, high-level, overview of the various Shapes Constraint Language (SHACL) specifications.
 			</p>
 			<p>
-				The second iteration of the World Wide Web Consortium's <a href="https://www.w3.org/groups/wg/data-shapes/">Data Shapes Working Group</a> aimed to "...update data shapes standards in line with the versions of core Semantic Web standards that cater for RDF-star and to extend the applications of data shapes with new packaging and use specifications". The outcome of the Working Group's operations was a set of specifications - W3C 'Recommendations' - that cover core SHACL elements, extended ones and SHACL functions beyond RDF validation, such as User Interface generation. The Overview section below lists all the Working Group specifications and they are also listed in each specification's Introduction too.
+				The second iteration of the World Wide Web Consortium's <a href="https://www.w3.org/groups/wg/data-shapes/">Data Shapes Working Group</a> aimed to "...update data shapes standards in line with the versions of core Semantic Web standards that cater for RDF-star and to extend the applications of data shapes with new packaging and use specifications". The outcome of the Working Group's operations was a set of specifications - W3C 'Recommendations' - that cover core SHACL elements, extended ones and SHACL functions beyond RDF validation, such as User Interface generation.
+			</p>
+			<p>
+				The <em>What's new in SHACL 1.2</em> section below describes the changes between SHACL, as published in 2017 and SHACL 1.2, including all the new SHACL elements such as SHACL for User Interface generation.
+			</p>
+			<p>
+				The <em>Specifications</em> section below lists all the Data Shapes Working Group's specifications which are also listed in each specification's Introduction.
+			</p>
+			<p>
+				The appendixes below contain material supporting the set of SHACL specifications and provide SHACL users with additional support, such as validators for shapes graphs.
 			</p>
 		</section>
 
-		<section id="governance">
-			<h2>Governance</h2>
-			<p class="todo">TODO: This section will describe the governance arrangements in place for the continued maintenance of this NOTE.</p>
+		<section id="whatsnew">
+			<h2>What's New in SHACL 1.2</h2>
+			<p>
+				<em>coming soon</em>
+			</p>
+		</section>
+
+		<section id="specifications">
+			<h2>Specifications</h2>
+			<p>
+				SHACL 1.2:
+			</p>
+			<ol>
+				<li>SHACL 1.2 Overview (this document)
+					<ul><li>overviews the set of SHACL specifications</li></ul>
+				</li>
+				<li>
+					<a href="https://w3c.github.io/data-shapes/shacl12-core/">SHACL 1.2 Core</a>
+					<ul><li>defines the Core of SHACL</li></ul>
+				</li>
+				<li>
+					<a href="https://w3c.github.io/data-shapes/shacl12-sparql/">SHACL 1.2 SPARQL Extensions</a>
+					<ul><li>defines SPARQL-related extensions of the SHACL</li></ul>
+				</li>
+				<li>
+					<a href="https://w3c.github.io/data-shapes/shacl12-node-expr/">SHACL 1.2 Node Expressions</a>
+					<ul><li>defines graph expressions used to determine focus nodes SHACL</li></ul>
+				</li>
+				<li>
+					<a href="https://w3c.github.io/data-shapes/shacl12-inf-rules/">SHACL 1.2 Inference Rules</a>
+					<ul><li>defines SHACL's methods of rule-based inference</li></ul>
+				</li>
+				<li>
+					<s><a href="https://w3c.github.io/data-shapes/shacl12-ui/">SHACL 1.2 UI</a></s>
+					<ul><li>defines SHACL's use for User Interface generation</li></ul>
+				</li>
+				<li>
+					<s><a href="https://w3c.github.io/data-shapes/shacl12-profiling/">SHACL 1.2 Profiling</a></s>
+					<ul><li>defines the use of SHACL for profiling data, including SHACL data</li></ul>
+				</li>
+			</ol>
 		</section>
 
 		<section id="x">
 			<h2>Section X</h2>
 			<p class="todo">TODO: This section will describe...</p>
 		</section>
 
+		<section id="shacl-shacl" class="appendix informative">
+			<h2>SHACL-SHACL</h2>
+			<p>
+				The <a href="https://www.w3.org/groups/wg/data-shapes/">Data Shapes Working Group</a> maintains SHACL graphs that can be used to validate other SHACL Shapes graphs, called "SHACL-SHACL". There is more than one to allow for the validation of subsets of the total body of SHACL elements defined in the various SHACL specifications.
+			</p>
+			<p>
+				Each SHACL-SHACL graph correspond to the scope of individual SHACL specifications and are available as RDF resources:
+			</p>
+			<ul>
+				<li>
+					<a href="">SHACL-SHACL all</a> - <em>the union of all other SHACL-SHACL graphs</em>
+				</li>
+				<li>
+					<a href="">SHACL-SHACL Core</a>
+				</li>
+				<li>
+					<a href="">SHACL-SHACL SPARQL</a>
+				</li>
+				<li>
+					<a href="">SHACL-SHACL Node Expressions</a>
+				</li>
+				<li>
+					<a href="">SHACL-SHACL Inference Rules</a>
+				</li>
+				<li>
+					<a href="">SHACL-SHACL UI</a>
+				</li>
+				<li>
+					<a href="">SHACL-SHACL Profiling</a>
+				</li>
+			</ul>
+		</section>
+
 		<section id="security" class="appendix informative">
 			<h2>Security and Privacy Considerations</h2>
 			<p>
@@ -392,13 +472,6 @@ <h2>Security and Privacy Considerations</h2>
 			</p>
 		</section>
 
-		<section id="validator" class="appendix normative">
-			<h2>SHACL-SHACL Validator</h2>
-			<p>
-				The shapes graph of SHACL-SHACL is available as an RDF resource at <a href="http://www.w3.org/ns/shacl-shacl">http://www.w3.org/ns/shacl-shacl</a>.
-			</p>
-		</section>
-
 		<section id="ack" class="appendix informative">
 			<h2>Acknowledgements</h2>
 			<p>Many people contributed to this document, including members of the RDF Data Shapes Working Group.</p>