LC Review of the RDF 1.1. Semantics document

Pat, Peter,

I have made a review of the latest version, ie,

https://dvcs.w3.org/hg/rdf/raw-file/040e24cdacf2/rdf-mt/index.html

I know that Peter plans some minor changes[1], and I am happy review 
those changes explicitly once they are in the document, but it may not 
be necessary. I did a review of a previous version in [2], and the 
changes that happened after that one in the document are fine (and may 
have made some of my comments moot). Other comments are below; all of 
them are minor and can be taken care of by the editor without involving 
the WG's time. Once they are done, I am fine releasing the document as a 
Last Call WD. And thanks to both of you...

Thanks

Ivan


Minor
-----

- At the beginning of section 5, we say '...I is a structure consisting 
of'... but then, in the semantic conditions, the same symbol 'I' is used 
as a function. AFAIK, this is a usual abuse of notation, but maybe it is 
better calling it out explicitly.

- Section 6, second paragraph after the change note, it says: "they may 
be at risk of introducing falsehoods and errors into otherwise correct 
RDF data": what does the term 'correct' means in this context? I would 
think it refers to the fact that it conforms to the C&AS document, 
although the conformance clause of that document is also a bit vague...

- Appendix B: I do not understand this: "plus a random member of each 
nonempty class or type". You mean an extra, random member that does not 
appear in the original graph? It is probably worth spelling out more and 
also why it is necessary (although I just saw Peter's comment[1] who 
seems to say that this clause may not be necessary at all, in which case 
this comment is moot...)


Editorial
---------

- Abstract: are we sure that a reference to a (not-yet existing...) 
Primer is the good reference for RDF 1.1? I think we should use 
Concepts. A reference to RDF-SCHEMA that does not yet exist may also be 
an issue.

- Third paragraph in section 3: 's' -> 'S' at the begining of the 
paragraph. Also, in the same paragraph, there should be some empty line 
before and after the ex:a... triple to make it more readable.

- Section 4, 4th paragraph: 'matter. the' -> 'matter, the'

- Section 6, last paragraph right before 6.1: the reference to TESTCASES 
is probably wrong in the respec source, it comes out as !-TESTCASES]] in 
the document when viewed in the browser...

- Section 6.1, remark on compactness: the text says 'This property is 
often called compactness': I presume 'this' means that the graph is 
finite. Maybe it is better spelling it out.

- Section 10.1, second example: 'ex:a ex:p"25"^^xsd:decimal .' -> 'ex:a 
ex:p "25"^^xsd:decimal .' (a space is missing)

- Appendix B, last-but-one paragraph: "truthvalues" -> "truth values"

- Appendix D.2, second paragraph: "The RDFS vocabulary, described below" 
-> "The RDFS vocabulary, described above", and a link to 'above' is 
probably a good idea

- Appendix D.3, last-but-one paragraph: "semantic extensions" -> 
"Semantic extensions"






[1] http://lists.w3.org/Archives/Public/public-rdf-wg/2013May/0258.html
[2] http://lists.w3.org/Archives/Public/public-rdf-wg/2013May/0107.html
-- 
Ivan Herman, W3C
Semantic Web Activity Lead
Home: http://www.w3.org/People/Ivan/
mobile: +31-641044153
http://www.ivan-herman.net/foaf#me

Received on Wednesday, 29 May 2013 10:09:30 UTC