Re: Fixes required in Test Cases and Implementation Report docs

On 2 Aug 2012, at 00:46, Boris Villazon-Terrazas wrote:
> 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.

That was fast :-) Great work.

I messed up one thing in my earlier email and swapped the URLs for "This version" and "Latest version". I fixed that now myself in the two documents above.

I also fixed a couple more small things I had missed earlier:

- removed the $Id$ thingy in the SotD sections (great for ED but inappropriate for published documents)
- added "This version is XXX" sentences to the References section with timestamped URLs
- changed the test case URLs in the ImplRep's pass/fail tables from the ED to TR space

Hope that's all ok.

Best,
Richard



> 
> 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 Thursday, 2 August 2012 00:24:24 UTC