[data-shapes] add colophon to figures (#503)

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

== add colophon to figures ==
Currently figures are inserted bare in the spec, eg see
https://raw.githack.com/vladimiralexiev/data-shapes/issue-486-ValidationReport-UML/shacl12-core/index.html#validation-report

https://respec.org/docs/#figure describes some things we can add; and I've added more from discussions:
- [ ] `<figure id>`
- [ ] `<figcaption>` 
- [ ] [table of figures](https://respec.org/docs/#id-tof).
- [ ] optional: references eg
`The figure shown in <a href="#figure"></a> is quite impressive`
- [ ] @TallTed asked: a longer description for visually impaired people (don't know how to do it for embedded `<svg>` rather than `<img>` tag)
- [ ] @HolgerKnublauch asked: any such diagram needs to be wrapped with a warning 
> The figure is purely informative and illustrative. In case of discrepancies, the written specification text has precedence.
- [ ] @afs and @HolgerKnublauch asked: hide in something like `<detail>` and have a switch on top to show/hide all figures
   - I could agree, as soon as jumping to the figure's anchor automatically reveals it. Else we can't share figures in email/discussions

@YoucTagh please comment

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


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

Received on Tuesday, 12 August 2025 10:15:59 UTC