search

w3c / rdf-semantics

https://w3c.github.io/rdf-semantics/
Other
5 stars 2 forks source link

Improve pictures in Sec.4 and 5 of RDF 1.2 Semantics #42

Closed Antoine-Zimmermann closed 11 months ago

Antoine-Zimmermann commented 1 year ago

The pictures used in Section 4.1 and Section 5.1.1 are pixelated and not looking nice. Vector graphics version should be produced and used.

pfps commented 1 year ago

Anyone can feel free to improve the graphics.

TallTed commented 1 year ago

I guess you mean these from 4.1 Shared blank nodes, unions and merges —

— and these from 5.1.1 Shared blank nodes (Informative) —

Yeah, these are terrible. JPG should never be used for such diagrams!

They should be fairly quick to recreate (and improve). Optimal replacements will be SVG with clear prose describing them to go alongside for a11y. What's the preferred tool these days?

gkellogg commented 12 months ago

I've used Google Docs to create many images such as this. For example quoted triple used in RDF Concepts.

quoted-triple

I then export the SVG and put it in the document directory, with a link back to the source for future reference. For example:

<figure id="fig-quoted-triple">
  <a href="quoted-triple.svg">
    <!-- Source for this file is at https://docs.google.com/drawings/d/1I_QxbUgnQXumXzb8c0WNJHIQ-mtRs2S80dDG6i9aOD8 -->
    <img src="quoted-triple.svg"
         alt="An RDF graph containing a triple that references an unasserted quoted triple (with grey background) as the subject"
         style="width:70%"
         aria-describedby="fig-quoted-triple-alt"/>
  </a>
  <figcaption id="fig-quoted-triple-alt">
    An RDF graph containing a triple that references an unasserted quoted triple (with grey background) as the subject.
  </figcaption>
</figure>

In this case, you could take a base drawing, and save it one for each figure. Make sure to make it publicly accessible and to allow edit writes so that it can be changed in the future.

Note the accessibility requirements for an alt description and description. Typically, the figure caption is adequate, but there are other ways to do this.

pfps commented 11 months ago

The pictures were added and this issue is editorial and has been lingering so I'm closing it.