--- a/bp/index.html Tue Mar 26 15:50:58 2013 -0400
+++ b/bp/index.html Tue Mar 26 16:16:10 2013 -0400
@@ -20,7 +20,7 @@
<section id="abstract">
<p>
-This document provides best practices for creating, publishing and announcing open government content as Linked Data. Guidance on the life cycle of a Linked Data project, beginning with identification of suitable data sets, vocabulary selection, URI naming conventions through publication of data sets is included. The goal of this document is to aid the publication of high quality <a href='http://www.w3.org/TR/gld-glossary/index.html#linked-open-data'>Linked Open Data (LOD)</a> from government authorities. This document aims to compile the most relevant data management practices, promoting best practices for publishing Linked Open Data and warns against practices that are considered harmful.
+This document provides best practices for creating, publishing and announcing open government content as Linked Data. Guidance on the life cycle of a Linked Data project, beginning with identification of suitable data sets, vocabulary selection, URI naming conventions through publication of data sets is included. The goal of this document is to aid the publication of high quality Linked Open Data (LOD) from government authorities. This document aims to compile the most relevant data management practices, promoting best practices for publishing Linked Open Data and warns against practices that are considered harmful.
</p>
</section>
@@ -30,6 +30,10 @@
<!-- INTRODUCTION -->
+
+<p class="todo"> (Editors) - Please link to Linked Data Glossary when short name approved.
+</p>
+
<section class="introductory">
<h2>Purpose of the Document</h2>
<p>
@@ -46,9 +50,9 @@
This document aims to facilitate the adoption of Linked Open Data Principles for publishing open government data on the Web. Linked Data utilizes the Resource Description Framework (RDF)
<p>
-<a href='http://www.w3.org/TR/gld-glossary/index.html#linked-data'>Linked Data</a> refers to a set of best practices for publishing and interlinking structured data for access by both humans and machines via the use of the RDF family of syntaxes (e.g., RDF/XML, N3, Turtle and N-Triples) and HTTP URIs. RDF and Linked Data are not the same thing.
+Linked Data refers to a set of best practices for publishing and interlinking structured data for access by both humans and machines via the use of the RDF family of syntaxes (e.g., RDF/XML, N3, Turtle and N-Triples) and HTTP URIs. RDF and Linked Data are not the same thing.
-Linked Data can be published by an person or organization behind the firewall or on the public Web. If Linked Data is published on the public Web, it is generally called <a href='http://www.w3.org/TR/gld-glossary/index.html#linked-open-data'>Linked Open Data</a>.
+Linked Data can be published by an person or organization behind the firewall or on the public Web. If Linked Data is published on the public Web, it is generally called Linked Open Data.
</p>
<h2>Background</h2>
@@ -74,10 +78,10 @@
<p class='stmt'><a href="#NAME">NAME</a> Use HTTP URIs as names for your objects. Give careful consideration to the URI naming strategy. Consider how the data will change over time and name as necessary.
</p>
-<p class='stmt'><a href="#STANDARD_VOCABULARIES">STANDARD_VOCABULARIES</a> Describe objects with standard vocabularies whenever possible.
+<p class='stmt'><a href="#STANDARD-VOCABULARIES">STANDARD_VOCABULARIES</a> Describe objects with standard vocabularies whenever possible.
</p>
-<p class='stmt'><a href="#CONSISTENT_REPRESENTATION">CONSISTENT_REPRESENTATION</a> Provide representations of a resource consistently and predictably.
+<p class='stmt'><a href="#CONSISTENT-REPRESENTATION">CONSISTENT_REPRESENTATION</a> Provide representations of a resource consistently and predictably.
</p>
<p class='stmt'><a href="#DESCRIPTIONS">DESCRIPTIONS</a> Publish human and machine readable descriptions with your Linked Data.
@@ -86,13 +90,13 @@
<p class='stmt'><a href="#CONVERT">CONVERT</a> Convert the source data into a Linked Data representation, also called an RDF serialization including Turtle, Notation-3 (N3), N-Triples, XHTML with embedded RDFa, and RDF/XML.
</p>
-<p class='stmt'><a href="#SPECIFY_LICENSE">SPECIFY_LICENSE</a> Specify an appropriate license.
+<p class='stmt'><a href="#SPECIFY-LICENSE">SPECIFY_LICENSE</a> Specify an appropriate license.
</p>
<p class='stmt'><a href="#ANNOUNCE">ANNOUNCE</a> Host Linked Open Data on the public Web and announce it.
</p>
-<p class='stmt'><a href="#SOCIAL_CONTRACT">SOCIAL_CONTRACT</a> Maintenance is critical. If you move or remove data that is published to the Web, you may break third party applications or mashups.
+<p class='stmt'><a href="#SOCIAL-CONTRACT">SOCIAL_CONTRACT</a> Maintenance is critical. If you move or remove data that is published to the Web, you may break third party applications or mashups.
</p>
@@ -135,21 +139,20 @@
<h2>Vocabulary Selection</h2>
<p>
-There are several core W3C vocabularies that allow a developer to describe basic or more complex relationships as Linked Data. Standardized vocabularies should be reused as much as possible to facilitate inclusion and expansion of the <a href='https://dvcs.w3.org/hg/gld/raw-file/default/glossary/index.html#web-of-data'>Web of data</a>. Government publishers are encouraged to use standardized vocabularies rather than reinventing the wheel, wherever possible.
+There are several core W3C vocabularies that allow a developer to describe basic or more complex relationships as Linked Data. Standardized vocabularies should be reused as much as possible to facilitate inclusion and expansion of the <a href="https://dvcs.w3.org/hg/gld/raw-file/default/glossary/index.html#web-of-data">Web of data</a>. Government publishers are encouraged to use standardized vocabularies rather than reinventing the wheel, wherever possible.
</p>
<p>
-For example, organizational structures and activities are often described by government authorities. The <a href='http://www.w3.org/TR/vocab-org/
-'>Organization Ontology</a> aims to support publishing of organizational information across a number of domains, as Linked Data. The Organizational Ontology is designed to allow domain-specific extensions to add classification of organizations and roles, as well as extensions to support neighbouring information such as organizational activities.
+For example, organizational structures and activities are often described by government authorities. The <a href="http://www.w3.org/TR/vocab-org/" target="_blank">Organization Ontology</a> aims to support publishing of organizational information across a number of domains, as Linked Data. The Organizational Ontology is designed to allow domain-specific extensions to add classification of organizations and roles, as well as extensions to support neighbouring information such as organizational activities.
</p>
<p>
-The <a href='http://www.w3.org/TR/vocab-dcat/'>Data Catalog Vocabulary (DCAT)</a> is an RDF vocabulary designed to facilitate interoperability between data catalogs published on the Web. By using DCAT to describe datasets in data catalogs, publishers increase discoverability and enable applications easily to consume metadata from multiple catalogs. It further enables decentralized publishing of catalogs and facilitates federated dataset search across sites. Aggregated DCAT metadata can serve as a manifest file to facilitate digital preservation.
+The <a href="http://www.w3.org/TR/vocab-dcat/" target="_blank">Data Catalog Vocabulary (DCAT)</a> is an RDF vocabulary designed to facilitate interoperability between data catalogs published on the Web. By using DCAT to describe datasets in data catalogs, publishers increase discoverability and enable applications easily to consume metadata from multiple catalogs. It further enables decentralized publishing of catalogs and facilitates federated dataset search across sites. Aggregated DCAT metadata can serve as a manifest file to facilitate digital preservation.
</p>
<p>
-Many government agencies publish statistical information on the public Web. The <a href="http://www.w3.org/TR/vocab-data-cube/">
-Data Cube Vocabulary</a> provides a means to do this using the <a href='http://www.w3.org/TR/gld-glossary/index.html#rdf'>Resource Description Framework (RDF)</a>. The model underpinning the Data Cube vocabulary is compatible with the cube model that underlies SDMX (Statistical Data and Metadata eXchange), an ISO standard for exchanging and sharing statistical data and metadata among organizations. The Data Cube vocabulary is a core foundation which supports extension vocabularies to enable publication of other aspects of statistical data flows or other multi-dimensional data sets.
+Many government agencies publish statistical information on the public Web. The <a href="http://www.w3.org/TR/vocab-data-cube/" target="_blank">
+Data Cube Vocabulary</a> provides a means to do this using the <a href="http://www.w3.org/TR/gld-glossary/index.html#rdf" target="_blank">Resource Description Framework (RDF)</a>. The model underpinning the Data Cube vocabulary is compatible with the cube model that underlies SDMX (Statistical Data and Metadata eXchange), an ISO standard for exchanging and sharing statistical data and metadata among organizations. The Data Cube vocabulary is a core foundation which supports extension vocabularies to enable publication of other aspects of statistical data flows or other multi-dimensional data sets.
</p>
<p class="todo"> To include: Phil suggests to include <a href="http://www.w3.org/QA/2012/07/conformance_for_vocabularies.html" target="_blank">Conformance for Vocabularies</a>.
@@ -188,10 +191,13 @@
</p>
-<!-- << is your linked data vocabulary 5 star? -->
+<!-- << is your Linked Data Vocabulary 5 star? -->
-<h3>Is your linked data vocabulary 5-star?</h3>
-Inspired by the 5-star linked data scale <a href="http://5stardata.info/" target="_blank">REF3</a>, we provide some suggestions on how do you make a 5-star vocabulary <a href="http://blog.hubjects.com/2012/02/is-your-linked-data-vocabulary-5-star_9588.html" target="_blank">REF4</a>.
+<p class="todo"> (Editors) - Update with attribution to Bernard Vatant's 5 Star Linked Data Vocabulary scheme (proposed).
+</p>
+
+<h3>Is your Linked Data Vocabulary 5-star?</h3>
+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://blog.hubjects.com/2012/02/is-your-linked-data-vocabulary-5-star_9588.html" target="_blank">REF4</a>.
<p class="highlight">☆ <b>Publish your vocabulary on the Web at a stable URI using an open license.</b>
</p>
@@ -593,7 +599,6 @@
</section>
-
<!-- PROCUREMENT -->
<section>
<h2>Procurement</h2>
--- a/bp/respec-config.js Tue Mar 26 15:50:58 2013 -0400
+++ b/bp/respec-config.js Tue Mar 26 16:16:10 2013 -0400
@@ -1,7 +1,7 @@
var respecConfig = {
// specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
specStatus: "ED",
- publishDate: "2013-03-13",
+ publishDate: "2013-03-26",
//copyrightStart: "2010",
// the specification's short name, as in http://www.w3.org/TR/short-name/