trying to fix issue-6 of bp doc
authoratemezi
Thu, 14 Nov 2013 02:20:59 +0100
changeset 636 21b5ac78fc83
parent 635 ebe0dd7a49ce
child 637 fdba86a54230
trying to fix issue-6 of bp doc
bp/index.html
--- a/bp/index.html	Thu Nov 14 02:02:42 2013 +0100
+++ b/bp/index.html	Thu Nov 14 02:20:59 2013 +0100
@@ -380,8 +380,10 @@
 <p><i>There will be cases in which authorities will need to mint their own vocabulary terms. This section provides a set of considerations aimed at helping to government stakeholders mint their own vocabulary terms. This section includes some items of the previous section because some recommendations for vocabulary selection also apply to vocabulary creation.</i> </p> 
 <p class="note"> Ensure new vocabularies you create are: 
 <b>Self-descriptive </b>, 
-<b>Described in more than one language, ideally </b> and 
-<b>Accessible for a long period</b>
+<b>Described in more than one language, ideally </b> ,
+<b>Accessible for a long period</b> ,
+<b>Link to other vocabularies by re-using elements rather than re-inventing</b>	,
+<b>on the Web at a stable URI using an open license </b>.
 </p>
 
 <p class="highlight"><b>Define the URI of the vocabulary.</b><br/>
@@ -415,35 +417,38 @@
 	<i>What it means:</i> It refers to the mechanism put in place by the publisher to always take care of backward compatibilities of the versions, the ways those changes affected the previous versions.  Major changes of the vocabularies should be reflected on the documentation, in both machine or human-readable formats. This is strongly related to the best practices described in the Versioning section.	
 </p>
 
-<p class="highlight"><b>Vocabularies should provide documentations</b><br/>
-	<i>What it means:</i> A vocabulary should be well-documented for machine readable (use of labels and comments; tags to language used).  Also for human-readable, an extra documentation should be provided by the publisher to better understand the classes and properties, and if possible with some valuable use cases.	
+<p class="highlight"><b>Vocabularies should provide documentation</b><br/>
+	<i>What it means:</i> A vocabulary should be well-documented for machine readable (use of labels and comments; tags to language used).  Also for human-readable, an extra documentation should be provided by the publisher to better understand the classes and properties, and if possible with some valuable use cases. <b>Provide human-readable documentation and basic metadata such as creator, publisher, date of creation, last modification, version number.</b>
 </p>
 
 <p class="highlight"><b>Vocabulary should be published following available best practices</b><br/>
-	<i>What it means:</i> One of the goals is to contribute to the community by sharing the new vocabulary. To this end, it is recommended to follow available recipes for publishing RDF vocabularies  e.g., <a href="http://www.w3.org/TR/swbp-vocab-pub/" target="_blank">Best Practice Recipes for Publishing RDF Vocabularies</a>[[BP-PUB]].	
+	<i>What it means:</i> <b>Publish your vocabulary on the Web at a stable URI using an open license.</b>. One of the goals is to contribute to the community by sharing the new vocabulary. To this end, it is recommended to follow available recipes for publishing RDF vocabularies  e.g., <a href="http://www.w3.org/TR/swbp-vocab-pub/" target="_blank">Best Practice Recipes for Publishing RDF Vocabularies</a>[[BP-PUB]].	
 </p>
-<!-- Vocabulary Creation -->
 
 </section>
-<br/>
+
+<!-- Vocabulary Creation -->
+<!--TODO: put this in other sections without mentioning 5-stars: recommendation of Sandro -->
+
+<!--<br/>
 <b>Is your Linked Data Vocabulary 5-star?</b>
 <br/>
-Inspired by the 5-star linked data scale <a href="http://5stardata.info/" target="_blank">5-Star Scheme</a>, suggestions on creating a 5-star vocabulary <a href="http://bvatant.blogspot.fr/2012/02/is-your-linked-data-vocabulary-5-star_9588.html" target="_blank">[[BV5STAR]]</a>.
-
-<p class="highlight">&#9734;&nbsp;<b>Publish your vocabulary on the Web at a stable URI using an open license.</b>	
-</p>
-
-<p class="highlight">&#9734;&#9734;&nbsp;<b>Provide human-readable documentation and basic metadata such as creator, publisher, date of creation, last modification, version number.</b>	
-</p>
+Inspired by the 5-star linked data scale <a href="http://5stardata.info/" target="_blank">5-Star Scheme</a>, suggestions on creating a 5-star vocabulary <a href="http://bvatant.blogspot.fr/2012/02/is-your-linked-data-vocabulary-5-star_9588.html" target="_blank">[[BV5STAR]]</a>. -->
 
-<p class="highlight">&#9734;&#9734;&#9734;&nbsp;<b>Provide labels and descriptions, if possible in several languages, to make your vocabulary usable in multiple linguistic scopes.</b>	
-</p>
+<!--<p class="highlight">&#9734;&nbsp;<b>Publish your vocabulary on the Web at a stable URI using an open license.</b>	
+</p> -->
 
-<p class="highlight">&#9734;&#9734;&#9734;&#9734;&nbsp;<b>Make your vocabulary available via its namespace URI, both as a formal file and human-readable documentation, using content negotiation.</b>	
-</p>
+<!--<p class="highlight">&#9734;&#9734;&nbsp;<b>Provide human-readable documentation and basic metadata such as creator, publisher, date of creation, last modification, version number.</b>	
+</p> -->
 
-<p class="highlight">&#9734;&#9734;&#9734;&#9734;&#9734;&nbsp;<b>Link to other vocabularies by re-using elements rather than re-inventing.</b>	
-</p>
+<!--<p class="highlight">&#9734;&#9734;&#9734;&nbsp;<b>Provide labels and descriptions, if possible in several languages, to make your vocabulary usable in multiple linguistic scopes.</b>	
+</p> -->
+
+<!--<p class="highlight">&#9734;&#9734;&#9734;&#9734;&nbsp;<b>Make your vocabulary available via its namespace URI, both as a formal file and human-readable documentation, using content negotiation.</b>	
+</p> -->
+
+<!--<p class="highlight">&#9734;&#9734;&#9734;&#9734;&#9734;&nbsp;<b>Link to other vocabularies by re-using elements rather than re-inventing.</b>	
+</p> -->
 
 
 <!-- TODO  -->
@@ -452,6 +457,7 @@
 
 <section id="multilingual" class="informative">
 <h2>Multilingual Vocabularies</h2>
+<p class="highlight"><b>While designing a vocabulary,provide labels and descriptions, if possible in several languages, to make your vocabulary usable in multiple linguistic scopes.</b> </p>	
 <p>
 This section provides some considerations when we are dealing with multilingualism in vocabularies. For more details on the multilingualism on the Web, see the <a href="http://www.w3.org/International/multilingualweb/lt/" target="_blank"> MultilingualWeb-LT Working Group</a> </p>
 <p> We have identified that multilingualism in vocabularies can be found nowadays in the following formats: