w3c / rdf-concepts

https://w3c.github.io/rdf-concepts/
Other
16 stars 2 forks source link

Update rdf:HTML and rdf:XMLLiteral definitions with DOM reference. #56

Closed gkellogg closed 1 year ago

gkellogg commented 1 year ago

This also makes the sections normative, as the text previously said they were informative because DOM4 (now simply DOM) was not a recommendation.

Note some minor changes in DOM method notation to facilitate definition references.


Preview | Diff

afs commented 1 year ago

The changes to the section look good - there is other text that needs updating.

In the intro of section 5.2:

Drop "Furthermore, the following IRIs are allocated for non-normative datatypes:"

Replace by:

</p>
<p>The following three datatype IRIs are defined in this section:</p>

Add rdf:JSON to the list.

(or remove the "furthermore" and drop the list because it's clear enough because they are in the TOC.)

Maybe move the "Semantic extensions" note down on paragraph so that immediately after the list of rdf:HTML,rdf:XMLLIteral,rdf:JSON, is the sentence "RDF processors are not required to recognize datatype IRIs."

This is important because clarifies that "normative" does not mean "required support" for RDF conformance. RDF terms with bad lexical forms due to datatypes can introduce contradictions (rdf:XMLLIteral used to do this).