Re: Fixes required in Test Cases and Implementation Report docs

Hi Richard

Thank you very much for taking care of this.

I updated both documents with your comments.
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/

Please let me know if there are more issues to solve.

Thanks again

Boris

	
On Aug 1, 2012, at 11:16 PM, Richard Cyganiak wrote:

> 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 23:46:47 UTC