fixing http://w3c.github.io/data-shapes/shacl/

I feel that the version of http://w3c.github.io/data-shapes/shacl/
that I reviewed (dated 10 August 2015) has three fatal problems.
- It does not reflect working group consensus.
- It provides a poor and misleading description of SHACL.
- It has  multiple severe technical problems.
Fixing of any of these problems requires significant changes to the
document.

Fixing the worst aspects of these problems requires at least the following
changes:
- Writing an introduction that reasonably describes SHACL.
- Replacing the example that uses controversial aspects of SHACL.
- Using a well-defined vocabulary to describe the major SHACL notions.
- Correctly describing the relationship between SHACL and RDFS and SPARQL.
- Discussing recursive shapes.
- Fixing or removing the UML diagrams.
- Fixing the description of how violations are reported.



Peter F. Patel-Schneider
Nuance Communications

Received on Monday, 7 September 2015 16:16:48 UTC