Re: Review of RDF Concepts

Hi Niklas,
indeed many of your changes are exactly what I wanted to propose as well.
Since I don’t think that understanding what’s going on in a text should be done via diff of its html encoding, I attach a PDF which is your version with my additional comments on it.
Section 1.5 has to be completely rewritten, IMHO.
All my comments and proposed changes wrt your version are emphasised by a big red cross on the left.
—e.



On 16 Jan 2025, at 00:21, Niklas Lindström <lindstream@gmail.com> wrote:

Dear all,

Here is my review of RDF Concepts (as a diff against my fork): https://github.com/w3c/rdf-concepts/compare/main...niklasl:rdf-concepts:rdf12proposition?expand=1


A preview of the results of those changes: https://raw.githack.com/niklasl/rdf-concepts/rdf12proposition/spec/index.html


In summary, this suggests to:
* Correct an initial missing mention of triple terms as an element of triples.
* Add some text about propositions, attempting to clarify the concept that triple terms denote, and therefore their intended usage.
* Use a variant of the triple term illustrations, based on suggestions by Pierre-Antoine for the corresponding illustration in the Primer PR.
* Clarify the difference between a triple and a triple term.

Others have made other suggestions in their reviews, many of which I also agree with. I have not incorporated those into this.

Best regards,
Niklas