- From: Karl Dubost <karl@la-grange.net>
- Date: Fri, 12 May 2006 15:51:08 +0900
- To: public-swbp-wg@w3.org
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