SHACL Profiling Document

[YoucTagh]

This is the intended document that will introduce and point to the SHACL Profiling document

• See this document rendered online here

Closes #334

[TallTed]

Minor, for clarity

[TallTed]

Note that W3C document accessibility standards advise against color coding when that is the only means of communicating some information (such as these Turtle document fragments, formal definitions, and syntax rules). Among other concerns are that these may all appear to be the same gray, to readers lacking color vision. We should look to other specifications from the past few years, to see examples that may be adapted to our use.

[nicholascar]

I have updated this doc to use the same colour coding conventions as the Core doc. This doesn't directly address this issue - colour is still used - but it does put "Shapes Graph" and "Data Graph" in the top left of all the coloured boxes, e.g. https://w3c.github.io/data-shapes/shacl12-core/#example-1. The grey boxes do not say "Syntax Rules".

Since this document now matches the Core doc, I suggest we proceed like this for now - all doc matching - and then we update them all with just the following:

"Throughout the document, color-coded boxes containing RDF graphs in Turtle and JSON-LD will appear."

goes to

"Throughout the document, color-coded boxes containing RDF graphs in Turtle and JSON-LD will appear. The color of the box as well as a title indicate whether they are a Shapes graph, a Data graph or something else."

[TallTed]

I would add a terminal comma, i.e., Shapes graph, a Data graph or something -> Shapes graph, a Data graph, or something.