Fixes required in Test Cases and Implementation Report docs

Boris, Michael,

My understanding is that TC and ImplRep will be published as W3C Notes. This means they get both timestamped URLs and permalinks in the http://www.w3.org/TR/ space.

I understand that these are the latest candidate documents:

http://www.w3.org/2001/sw/rdb2rdf/test-cases/NOTE-rdb2rdf-tc-20120724/
http://www.w3.org/2001/sw/rdb2rdf/implementation-report/NOTE-rdb2rdf-ir-20120724/

I reviewed both from a W3C style point of view and they still need quite a few changes! A list is below.

(I can help make those changes tomorrow morning if necessary.)

Best,
Richard


1. Date of publication needs to be changed to 14 August 2012

2. “This version” needs to point to correct timestamped URL *in TR space*

• http://www.w3.org/TR/rdb2rdf-test-cases/
• http://www.w3.org/TR/rdb2rdf-implementations/

3. “Latest version” needs to point to untimestamped shortname *in TR space*

• http://www.w3.org/TR/2012/NOTE-rdb2rdf-test-cases-20120814/
• http://www.w3.org/TR/2012/NOTE-rdb2rdf-implementations-20120814/

4. SotD needs to be for a NOTE, not for an ED. I'm not sure what exactly the SotD should say, but I guess you can use these as rough templates:

• http://www.w3.org/TR/rdf-api/
• http://www.w3.org/TR/swbp-n-aryRelations/

5. References in the ImplRep need to use URLs in TR space with correct date, timestamp, and without “work in progress” markers.

6. Many URLs in the body of both documents need to be updated from ED or from old WD/CR to latest PR URLs (or alrernatively to untimestamped shortname URL in TR space). This includes all the spec references in the TC, and all the TC links in the ImplRep.

7. TC Section 4 contains a messed-up link to "Section 10 of the R2RML specification"; I guess the intended target URL is http://www.w3.org/TR/r2rml/#note-natural-mapping-extensions

8. ImplRep Section 4 (References) contains a messed-up reference for [RDB2RDF TC], there is some stuff about RDFa in there!?

9. ImplRep calls it once [Direct Mapping] and then [DM]

10. ImplRep defines a ref for [RDB2RDF-WG] that is never used, delete!

Received on Wednesday, 1 August 2012 21:17:14 UTC