[VM] review of March 16 editor's draft

Dear Elisa,

These are my comments to the March 16 editor's draft of "Principles of
Good Practice for Managing RDF Vocabularies and OWL Ontologies" [1].

[1] http://www.w3.org/2006/07/SWD/Vocab/principles-20080316

Best,

*****

General comment:

I think the document is moving to a maturity level and it is ready to be
aired. The most important aspects of vocab management are covered, and
five clear recommendations can be found. I would suggest to put more
visual stress on these recommendations, so they catch the eye even when
skimming the document. Please consider putting a colorized frame box to
the list at the beginning of section 2.

*****

Specific comments:

* Sect 2.1: the Recipes documents cited as guidelines to choose URI
namespaces. While the Recipes indeed contain some advise on this topic,
they also make the following remark: [[ This document is intended for
creators and maintainers of existing vocabularies. Proper guidance on
choosing the best URI namespace for any given situation is beyond the
scope of this document. ]]. I would suggest to rephrase the citation in
order to not to create too many expectations.

* Sect 2.2: I would add some sentences about RDFS annotation properties
(rdfs:label, rdfs:comment), and their importance to provide in-line,
multilingual documentation of the vocabularies.

* Sect 2.2: Related to the previous comment, I would suggest to include
something about tools that can generate readable documentation (HTML)
from the annotated vocabularies. One of such tools is SpecGen [2], which
is being used to create HTML documentation for the SIOC ontology.

[2] http://forge.morfeo-project.org/wiki_en/index.php/SpecGen

* Sect 2.2: There is a cite to the Recipes at the end of this section,
but I would suggest to complement it with some words about the
convenience of making human-readable documentation and machine-readable
definitions from the same URI using content-negotiation.

* Sect 2.3: There was a recent thread on semantic-web@w3.org regarding
the convenience of publishing early drafts of ontologies [3]. I wonder
if it is worth to mention this topic here.

[3] http://lists.w3.org/Archives/Public/semantic-web/2008Mar/0119.html

* Sect 2.5: s/accept=/Accept: /

* Section 6 (References), cite WEBARCH: s/and and/and/

-- 
Diego Berrueta
R&D Department  -  CTIC Foundation
E-mail: diego.berrueta@fundacionctic.org
Phone: +34 984 29 12 12
Parque Científico Tecnológico Gijón-Asturias-Spain
www.fundacionctic.org

Received on Tuesday, 8 April 2008 10:34:40 UTC