Spec editing to-do list

[cygri]

• Worked Example section (Arofan, Benedikt) (see issue worked example #65) [done]
• Class/property reference (from Turtle?) (Olof) (see issue references with properties for each class #60)
• Thorough review and editing pass (Achim, Arofan, Richard) (see issue [html spec] proofreading #64)
• Do examples throughout the main sections (Ben) (see issue examples throughout the main sections #67)
• detailed description of terms mentioned in UML diagrams (Thomas) [done]

[borsna]

I have created a script for generating documentation out of the turtle-file (converts it to rdf/xml and then applies a xslt)
I have only a windows build-script at the moment, bash-file coming soon.

Example of the output in in the documentation folder.
Online example of the rendered documentation can be found here: https://dl.dropbox.com/u/37711156/disco-spec-documentation/documentation/discovery.html

[boschthomas]

Olof, good work!

I think Richard recommended LODE for the same purpose:
http://www.essepuntato.it/lode
Unfortunately, it doesn't work at the moment.

[borsna]

Thomas: thanks, i will have a look at LODE when its online again, in the meantime the xslt will work for the basic needs.
I looked at the 'rdfs:comment's in the model and i think we should use it primarily for describing the Class or property and not general information about using dcterms etc. I think the descriptions from the dublin core paper is a good start for explaining the terms we use.

[boschthomas]

I agree.
Olof, you are modifying the rdfs:comments?

[borsna]

Thomas: i will replace them later this week with the descriptions used in the paper and write new ones for those missing. Will tell you when a review is needed.

[boschthomas]

Olof, please use the defintions from the spec. I added the definitions from the DC paper.

[borsna]

Thomas: okay will pick them from there.

[boschthomas]

already covered by other open issues