[data-shapes] Compact syntax examples in Core document - Upkeep and draft document link (#460)

ajnelson-nist has just created a new issue for https://github.com/w3c/data-shapes:

== Compact syntax examples in Core document - Upkeep and draft document link ==
On today's working-group call, someone mentioned that the Core document had picked up SHACL-C (Compact) syntax for its examples.

@YoucTagh [noted this in the PR adding the SHACL-C snippets](https://github.com/w3c/data-shapes/pull/421#issuecomment-3088017515):

> I am adding my review late, but there are 28 Shapes graph boxes with Turtle and JSON-LD only, with no SHACL-C. Is this intentional?

The SHACL-C snippet mention on today's call was pertaining to getting continuous-updating draft documents started up for several documents, including SHACL-C.  As I understood the question on the call, it amounted to:

1. Should the Core document have SHACL-C snippets for its examples?

It seems this was already decided sufficiently in #419 to add the snippets.  Do we need to revisit this decision?

If we remain fine with keeping snippets in Core, then we should probably consider this another nudge to get the SHACL-C document up to the same continuous-updating state as Core.

In light of @YoucTagh 's observation, we seem to have a review-rule need, that examples should consistently provide alternative syntaxes, maybe unless they self-excuse because we hit something SHACL-C can't currently support.

I suggest these resolution steps for this Issue:

- [ ] Affirm, or revisit, SHACL-C inclusion in Core.
- [ ] Devise a system (whether programmed, or social (checkboxes in PR template?)) to keep SHACL-C consistent with JSON-LD on Core.
- [ ] See whether that SHACL-C presence system applies to any SHACL documents aside from Core.

Please view or discuss this issue at https://github.com/w3c/data-shapes/issues/460 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Monday, 4 August 2025 12:51:16 UTC