Skip to content

Commit 3b249ba

Browse files
nicholascarnicholascar
committed
resolving several of @ajnelson-nist 's comments
1 parent 3db8720 commit 3b249ba

File tree

1 file changed

+46
-45
lines changed

1 file changed

+46
-45
lines changed

‎shacl12-overview/index.html

Lines changed: 46 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -366,7 +366,7 @@ <h2>Introduction</h2>
366366
This document provides a non-normative, high-level, overview of the various Shapes Constraint Language (SHACL) specifications.
367367
</p>
368368
<p>
369-
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.
369+
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 elements for advanced validation and SHACL functions beyond validation, such as User Interface generation.
370370
</p>
371371
<p>
372372
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.
@@ -381,52 +381,65 @@ <h2>Introduction</h2>
381381

382382
<section id="whatsnew">
383383
<h2>What's New in SHACL 1.2</h2>
384+
<p class="todo">
385+
The main information about SHACL 1.0 &rarr; 1.2 will be added here.
386+
</p>
387+
<h4>SHACL-SHACL</h4>
388+
<p>
389+
SHACL 1.0 included all the information about SHACL-SHACL at the time inline, within an Appendix, consisting of an
390+
introductory paragraph and the SHACL-SHACL RDF data only. SHACL 1.2 has moved this information to an appendix in this Overview..
391+
</p>
384392
<p>
385-
<em>coming soon</em>
393+
A note about this new SHACL-SHACL location is retained in SHACL 1.2 Core.
386394
</p>
387395
</section>
388396

389397
<section id="specifications">
390398
<h2>Specifications</h2>
391-
<p>
399+
<h3>
392400
SHACL 1.2:
393-
</p>
394-
<ol>
395-
<li>SHACL 1.2 Overview (this document)
396-
<ul><li>overviews the set of SHACL specifications</li></ul>
397-
</li>
398-
<li>
399-
<a href="https://w3c.github.io/data-shapes/shacl12-core/">SHACL 1.2 Core</a>
400-
<ul><li>defines the Core of SHACL</li></ul>
401-
</li>
402-
<li>
403-
<a href="https://w3c.github.io/data-shapes/shacl12-sparql/">SHACL 1.2 SPARQL Extensions</a>
404-
<ul><li>defines SPARQL-related extensions of the SHACL</li></ul>
405-
</li>
406-
<li>
407-
<a href="https://w3c.github.io/data-shapes/shacl12-node-expr/">SHACL 1.2 Node Expressions</a>
408-
<ul><li>defines graph expressions used to determine focus nodes SHACL</li></ul>
409-
</li>
410-
<li>
411-
<a href="https://w3c.github.io/data-shapes/shacl12-inf-rules/">SHACL 1.2 Inference Rules</a>
412-
<ul><li>defines SHACL's methods of rule-based inference</li></ul>
413-
</li>
414-
<li>
415-
<s><a href="https://w3c.github.io/data-shapes/shacl12-ui/">SHACL 1.2 UI</a></s>
416-
<ul><li>defines SHACL's use for User Interface generation</li></ul>
417-
</li>
418-
<li>
419-
<s><a href="https://w3c.github.io/data-shapes/shacl12-profiling/">SHACL 1.2 Profiling</a></s>
420-
<ul><li>defines the use of SHACL for profiling data, including SHACL data</li></ul>
421-
</li>
422-
</ol>
401+
</h3>
402+
<dl>
403+
<dt>SHACL 1.2 Overview (this document)</dt>
404+
<dd>overviews the set of SHACL specifications</dd>
405+
<dt><a href="https://w3c.github.io/data-shapes/shacl12-core/">SHACL 1.2 Core</a></dt>
406+
<dd>defines the Core of SHACL</dd>
407+
<dt><a href="https://w3c.github.io/data-shapes/shacl12-sparql/">SHACL 1.2 SPARQL Extensions</a></dt>
408+
<dd>defines SPARQL-related extensions of the SHACL</dd>
409+
<dt><a href="https://w3c.github.io/data-shapes/shacl12-node-expr/">SHACL 1.2 Node Expressions</a></dt>
410+
<dd>defines graph expressions used to determine focus nodes in SHACL</dd>
411+
<dt><a href="https://w3c.github.io/data-shapes/shacl12-inf-rules/">SHACL 1.2 Inference Rules</a></dt>
412+
<dd>defines SHACL's methods of rule-based inference</dd>
413+
<dt><s><a href="https://w3c.github.io/data-shapes/shacl12-ui/">SHACL 1.2 UI</a></s></dt>
414+
<dd>defines SHACL's use for User Interface generation</dd>
415+
<dt><s><a href="https://w3c.github.io/data-shapes/shacl12-profiling/">SHACL 1.2 Profiling</a></s></dt>
416+
<dd>defines the use of SHACL for profiling data, including SHACL data</dd>
417+
</dl>
418+
419+
<h3>
420+
SHACL 1.0:
421+
</h3>
422+
<p><em>The original SHACL specifications, now deprecated in favour of SHACL 1.2 specifications, above.</em></p>
423+
<dl>
424+
<dt><a href="https://www.w3.org/TR/shacl/">SHACL</a></dt>
425+
<dd></dd>
426+
<dt><a href="https://www.w3.org/TR/shacl-af/">SHACL Advanced Features</a></dt>
427+
<dd></dd>
428+
<dt><a href="https://www.w3.org/TR/shacl-js/">SHACL Javascript Extensions</a></dt>
429+
<dd></dd>
430+
</dl>
423431
</section>
424432

425433
<section id="x">
426434
<h2>Section X</h2>
427435
<p class="todo">TODO: This section will describe...</p>
428436
</section>
429437

438+
<section id="governance">
439+
<h3>Governance</h3>
440+
<p class="todo">TODO: This section will describe the governance arrangements in place for the continued maintenance of SHACL-SHACL resources, i.e., handling updates beyond the time frame of the Working Group's Charter.</p>
441+
</section>
442+
430443
<section id="shacl-shacl" class="appendix informative">
431444
<h2>SHACL-SHACL</h2>
432445
<p>
@@ -476,17 +489,5 @@ <h2>Security and Privacy Considerations</h2>
476489
<h2>Acknowledgements</h2>
477490
<p>Many people contributed to this document, including members of the RDF Data Shapes Working Group.</p>
478491
</section>
479-
480-
<section class="appendix informative" id="changes-12">
481-
<h2>Changes between SHACL 1.0 Core and SHACL 1.2 Core</h2>
482-
<p>
483-
SHACL 1.0 included the total information about SHACL-SHACL inline, within an Appendix, consisting of an
484-
introductory paragraph and the SHACL-SHACL RDF data only. SHACL 1.2 has dedicated this entire Note to
485-
define and describe SHACL-SHACL.
486-
</p>
487-
<p>
488-
A reference to this Note is retained in SHACL 1.2 Core.
489-
</p>
490-
</section>
491492
</body>
492493
</html>

0 commit comments

Comments
 (0)