cygri / void

An RDF schema and associated documentation for expressing metadata about RDF datasets
http://www.w3.org/TR/void/
14 stars 1 forks source link

Is the voiD Guide a tutorial or a reference document? #77

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
There are major differences in the tone between different sections.

Much of the stuff I wrote sounds like a technical specification. Much of the 
stuff Michael wrote sounds like an informal tutorial.

We should clarify what tone we want, and unify it a bit across the document.

Original issue reported on code.google.com by richard....@gmail.com on 31 Oct 2010 at 12:03

GoogleCodeExporter commented 9 years ago
IMO it's a technical spec. Where this is not the case it should be changed. Can 
you be more specific please? ... 'much of the stuff Michael wrote' does not 
really help ;)

Note that I labeled this with MR2 as it is a no-brainer IMO that we need to 
clarify this ASAP.

Original comment by Michael.Hausenblas on 31 Oct 2010 at 9:28

GoogleCodeExporter commented 9 years ago
Section 1.1 especially, and to a lesser degree some bits and pieces throughout 
Section 2 (starting with its first sentence!)

Original comment by richard....@gmail.com on 31 Oct 2010 at 12:42

GoogleCodeExporter commented 9 years ago
In today's telecon we agreed that it's a technical document that tells people 
how to use all the parts of void.

Original comment by richard....@gmail.com on 22 Nov 2010 at 12:46