comment: BP Recipes for Publishing RDF Vocabularies - Abstract

Hi,
This is a QA Review comment for "Best Practice Recipes for Publishing  
RDF Vocabularies"
http://www.w3.org/TR/2006/WD-swbp-vocab-pub-20060314/
Tue, 14 Mar 2006 12:48:26 GMT
1st WD

[[[
This document describes best practice recipes for publishing an RDFS  
or OWL vocabulary or ontology on the Web. The features of each recipe  
are clearly described, so that vocabulary or ontology creators may  
choose the recipe best suited to the needs of their particular  
situations. Each recipe contains an example configuration for use  
with an Apache HTTP server, although the principles involved may be  
adapted to other environments. The recipes are all designed to be  
consistent with the architecture of the Web as currently specified.
]]]

-- Best Practice Recipes for Publishing RDF Vocabularies
http://www.w3.org/TR/2006/WD-swbp-vocab-pub-20060314/
Tue, 14 Mar 2006 12:48:26 GMT


I'm not sure that people know what are
	- RDFS vocabulary
	- OWL vocabulary

"Ontology on the web" makes perfect sense. Maybe the document should  
start with:

	This document describes best practice recipes for
	publishing vocabularies or ontologies on the Web
	(in <acronym title="Resource Description Framework">RDF</acronym>
	Schema or <acronym title="Web Ontology Language">OWL</acronym>).

"The features of each recipe are clearly described, so that  
vocabulary or ontology creators may choose the recipe best suited to  
the needs of their particular situations."

*clearly* is usually abusive, this is the intent, it doesn't mean  
it's how the reader will perceive it. Maybe write something like  
that, lighter, shorter. An ontology is a kind of vocabulary,  
repeating the words might make the text a bit heavy.

	"The features of each recipe are described in details,
	so that vocabulary designers may choose the recipe best
	suited to their needs."


"Each recipe contains an example configuration for use with an Apache  
HTTP server, although the principles involved may be adapted to other  
environments. "

I would write this the other way around :)

	"Each recipe introduces general principles and an
	 example configuration for use with an Apache HTTP server
	(which may be adapted to other environments)."

btw, here there's a good opportunity to create a template and/or  
invite people to submit bindings to the Mailing List, id est how  
people applied this recipe in this particular server environment, Web  
Apps Framework, HTTP Servers only, etc. That would help other people  
to find the information. With a proposed template, it would help  
people to collect, gather the information.


Maybe a link to the Architecture of the Web document too. :)





-- 
Karl Dubost - Tokyo, Japon
karl@la-grange.net

Received on Friday, 12 May 2006 06:51:16 UTC