Updating metadata recommendations follow Richard's suggestions
authorDave Reynolds <dave@epimorphics.com>
Fri, 08 Mar 2013 14:21:02 +0000
changeset 368 d394eeeb9bf4
parent 367 fd984093d4e1
child 369 65dd83eab167
Updating metadata recommendations follow Richard's suggestions
data-cube/index.html
data-cube/static.html
respec/gld-bib.js
--- a/data-cube/index.html	Fri Mar 08 13:48:36 2013 +0000
+++ b/data-cube/index.html	Fri Mar 08 14:21:02 2013 +0000
@@ -1389,18 +1389,37 @@
 <h2>DataSet metadata</h2>
 
 <p>DataSets should be marked up with metadata to support discovery, presentation and
-processing. Metadata such as a display label (<code>rdfs:label</code>),
-descriptive comment (<code>rdfs:comment</code>) and creation date (<code>dcterms:date</code>)
-are common to most resources. We recommend use of Dublin Core Terms
-for representing the key metadata annotations commonly needed for DataSets.</p>
+  processing. Dublin Core Terms [[!DC11]] SHOULD be used
+  for representing the key metadata annotations commonly needed for
+  DataSets. The RDFS terms for display label (<code>rdfs:label</code>)
+  descriptive comment (<code>rdfs:comment</code>) SHOULD be given as
+  well for compatibility with earlier versions of Data Cube and common
+  RDF practice.
+</p>
 
+<p>The recommend core set of metadata terms is:</p>
+<ul>
+  <li><code>dct:title</code></li>
+  <li><code>rdfs:label</code> - may be same as <code>dct:title</code></li>
+  <li><code>dct:description</code></li>
+  <li><code>rdfs:comment</code> - may be same as <code>dct:description</code></li>
+  <li><code>dct:issued</code></li>
+  <li><code>dct:modified</code></li>
+  <li><code>dct:subject</code></li>
+  <li><code>dct:publisher</code></li>
+  <li><code>dct:license</code></li>
+</ul>
 
+<p>Other documents, notably [[DCAT]], provide additional
+  recommendations for metadata terms for data sets
+  which may be used for describing Data Cube DataSets.</p>
+  
 <section id="metadata-categorization">
 <h3>Categorizing a data set</h3>
 
 <p>Publishers of statistics often categorize their data sets into different statistical 
 domains, such as <em>Education</em>, <em>Labour</em>, or <em>Transportation</em>.
-We encourage use of <code>dcterms:subject</code> to record such a classification of
+We encourage use of <code>dct:subject</code> to record such a classification of
 a whole data set.
 The classification terms can include coarse grained classifications, such
 as the List of Subject-matter Domains from the SDMX Content-oriented Guidelines, 
@@ -1414,10 +1433,12 @@
 
 <pre class="example">
   eg:dataset1 a qb:DataSet;
-      rdfs:label "Life expectancy"@en;
-      rdfs:comment "Life expectancy within Welsh Unitary authorities - extracted from Stats Wales"@en;
-      dcterms:date "2010-08-11"^^xsd:date;
-      dcterms:subject
+      rdfs:label      "Life expectancy"@en;
+      dct:title       "Life expectancy"@en;
+      rdfs:comment    "Life expectancy within Welsh Unitary authorities - extracted from Stats Wales"@en;
+      dct:description "Life expectancy within Welsh Unitary authorities - extracted from Stats Wales"@en;
+      dct:issued      "2010-08-11"^^xsd:date;
+      dct:subject
           sdmx-subject:3.2 ,      # regional and small area statistics
           sdmx-subject:1.4 ,      # Health
           ex:wales;               # Wales
@@ -1433,13 +1454,13 @@
 <h3>Describing publishers</h3>
 
 <p>The organization that publishes a dataset should be recorded as part of the dataset metadata.
-Again we recommend use of the Dublin Core term <code>dcterms:publisher</code> for this.
+Again we recommend use of the Dublin Core term <code>dct:publisher</code> for this.
 The organization should be represented as an instance of <code>foaf:Agent</code>, or
 some more specific subclass such as <code>org:Organization</code> [[ORG]].</p>
 
 <pre class="example">
 eg:dataset1 a qb:DataSet;
-    dc:publisher &lt;http://example.com/meta#organization> .
+    dct:publisher &lt;http://example.com/meta#organization> .
     
 &lt;http://example.com/meta#organization> a org:Organization, foaf:Agent;
     rdfs:label "Example org" .    
--- a/data-cube/static.html	Fri Mar 08 13:48:36 2013 +0000
+++ b/data-cube/static.html	Fri Mar 08 14:21:02 2013 +0000
@@ -249,8 +249,8 @@
   <dt>Contributor:</dt> <dd><a href="http://www.jenitennison.com/">Jeni Tennison</a></dd></dl>
   
   
-      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2013 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p>
-  
+      <p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2013 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p>  
+    
   <hr>
 </div>
 
@@ -1051,7 +1051,15 @@
 </p>
   
 <p>The data cube vocabulary permits either representation approach to be used though they cannot be mixed
-  within the same data set.</p>
+  within the same data set. </p>
+
+<p>Both representation approaches require
+  that, for every point in the space of dimensions for which there is
+  an observation, then a value must be given for every measure. In the
+  case of multi-measure observations then each measure must be
+  present on each observation. In cubes which use a measure dimension
+  then there are sets of observations for each populated point in the
+  cube and within each of those sets there must be an observation giving each measure.</p>
   
 
 <section id="dsd-mm-obs">
@@ -1638,18 +1646,37 @@
 <!--OddPage--><h2><span class="secno">9. </span>DataSet metadata</h2>
 
 <p>DataSets should be marked up with metadata to support discovery, presentation and
-processing. Metadata such as a display label (<code>rdfs:label</code>),
-descriptive comment (<code>rdfs:comment</code>) and creation date (<code>dcterms:date</code>)
-are common to most resources. We recommend use of Dublin Core Terms
-for representing the key metadata annotations commonly needed for DataSets.</p>
-
-
+  processing. Dublin Core Terms [<cite><a class="bibref" href="#bib-DC11">DC11</a></cite>] <em class="rfc2119" title="should">should</em> be used
+  for representing the key metadata annotations commonly needed for
+  DataSets. The RDFS terms for display label (<code>rdfs:label</code>)
+  descriptive comment (<code>rdfs:comment</code>) <em class="rfc2119" title="should">should</em> be given as
+  well for compatibility with earlier versions of Data Cube and common
+  RDF practice.
+</p>
+
+<p>The recommend core set of metadata terms is:</p>
+<ul>
+  <li><code>dct:title</code></li>
+  <li><code>rdfs:label</code> - may be same as <code>dct:title</code></li>
+  <li><code>dct:description</code></li>
+  <li><code>rdfs:comment</code> - may be same as <code>dct:description</code></li>
+  <li><code>dct:issued</code></li>
+  <li><code>dct:modified</code></li>
+  <li><code>dct:subject</code></li>
+  <li><code>dct:publisher</code></li>
+  <li><code>dct:license</code></li>
+</ul>
+
+<p>Other documents, notably [<cite><a class="bibref" href="#bib-DCAT">DCAT</a></cite>], provide additional
+  recommendations for metadata terms for data sets
+  which may be used for describing Data Cube DataSets.</p>
+  
 <section id="metadata-categorization">
 <h3><span class="secno">9.1 </span>Categorizing a data set</h3>
 
 <p>Publishers of statistics often categorize their data sets into different statistical 
 domains, such as <em>Education</em>, <em>Labour</em>, or <em>Transportation</em>.
-We encourage use of <code>dcterms:subject</code> to record such a classification of
+We encourage use of <code>dct:subject</code> to record such a classification of
 a whole data set.
 The classification terms can include coarse grained classifications, such
 as the List of Subject-matter Domains from the SDMX Content-oriented Guidelines, 
@@ -1662,10 +1689,12 @@
 <p>Thus our sample dataset might be marked up by:</p>
 
 <div class="example"><div class="example-title"><span>Example 18</span></div><pre class="example">eg:dataset1 a qb:DataSet;
-    rdfs:label "Life expectancy"@en;
-    rdfs:comment "Life expectancy within Welsh Unitary authorities - extracted from Stats Wales"@en;
-    dcterms:date "2010-08-11"^^xsd:date;
-    dcterms:subject
+    rdfs:label      "Life expectancy"@en;
+    dct:title       "Life expectancy"@en;
+    rdfs:comment    "Life expectancy within Welsh Unitary authorities - extracted from Stats Wales"@en;
+    dct:description "Life expectancy within Welsh Unitary authorities - extracted from Stats Wales"@en;
+    dct:issued      "2010-08-11"^^xsd:date;
+    dct:subject
         sdmx-subject:3.2 ,      # regional and small area statistics
         sdmx-subject:1.4 ,      # Health
         ex:wales;               # Wales
@@ -1680,12 +1709,12 @@
 <h3><span class="secno">9.2 </span>Describing publishers</h3>
 
 <p>The organization that publishes a dataset should be recorded as part of the dataset metadata.
-Again we recommend use of the Dublin Core term <code>dcterms:publisher</code> for this.
+Again we recommend use of the Dublin Core term <code>dct:publisher</code> for this.
 The organization should be represented as an instance of <code>foaf:Agent</code>, or
 some more specific subclass such as <code>org:Organization</code> [<cite><a class="bibref" href="#bib-ORG">ORG</a></cite>].</p>
 
 <div class="example"><div class="example-title"><span>Example 19</span></div><pre class="example">eg:dataset1 a qb:DataSet;
-    dc:publisher &lt;http://example.com/meta#organization&gt; .
+    dct:publisher &lt;http://example.com/meta#organization&gt; .
     
 &lt;http://example.com/meta#organization&gt; a org:Organization, foaf:Agent;
     rdfs:label "Example org" .    </pre></div>
@@ -2290,10 +2319,10 @@
 definition of the code list as well as the Data Cube to be checked. In the case
 of a <code>skos:ConceptScheme</code> then each concept must be linked to the scheme using
 <code>skos:inScheme</code>. In the case of a <code>skos:Collection</code> then the
-collection must link to each concept using <code>skos:member</code> (i.e. if the
+collection must link to each concept or nested collection using <code>skos:member</code> (i.e. if the
 collection uses <code>skos:memberList</code> then the entailment of <code>skos:member</code>
 values defined by <a href="http://www.w3.org/TR/2009/REC-skos-reference-20090818/#S36">S36</a>
-in [<cite><a class="bibref" href="#bib-SKOS-REFERENCE">SKOS-REFERENCE</a></cite>] must be materialized).</p>
+in [<cite><a class="bibref" href="#bib-SKOS-REFERENCE">SKOS-REFERENCE</a></cite>] must be materialized). </p>
 
 <table class="bordered-table">
   <tbody>
@@ -2312,7 +2341,7 @@
         qb:codeList ?list .
     ?list a skos:Collection .
     ?obs ?dim ?v .
-    FILTER NOT EXISTS { ?list skos:member ?v }
+    FILTER NOT EXISTS { ?list skos:member+ ?v }
 }
     </pre></td></tr>
   </tbody>
@@ -2882,7 +2911,8 @@
 
 
 
-<section id="references" class="appendix"><!--OddPage--><h2><span class="secno">C. </span>References</h2><section id="normative-references"><h3><span class="secno">C.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-OWL2-PRIMER">[OWL2-PRIMER]</dt><dd>Pascal Hitzler; Markus Krötzsch; Bijan Parsia; Peter F. Patel-Schneider; Sebastian Rudolph. <a href="http://www.w3.org/TR/2009/REC-owl2-primer-20091027/"><cite>OWL 2 Web Ontology Language:Primer.</cite></a> 27 October 2009. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2009/REC-owl2-primer-20091027/">http://www.w3.org/TR/2009/REC-owl2-primer-20091027/</a>
+<section id="references" class="appendix"><!--OddPage--><h2><span class="secno">C. </span>References</h2><section id="normative-references"><h3><span class="secno">C.1 </span>Normative references</h3><dl class="bibliography"><dt id="bib-DC11">[DC11]</dt><dd>Dublin Core metadata initiative. <a href="http://dublincore.org/documents/dcmi-terms/"><cite>Dublin Core metadata element set, version 1.1.</cite></a> July 1999. Dublin Core recommendation. URL: <a href="http://dublincore.org/documents/dcmi-terms/">http://dublincore.org/documents/dcmi-terms/</a>
+</dd><dt id="bib-OWL2-PRIMER">[OWL2-PRIMER]</dt><dd>Pascal Hitzler; Markus Krötzsch; Bijan Parsia; Peter F. Patel-Schneider; Sebastian Rudolph. <a href="http://www.w3.org/TR/2009/REC-owl2-primer-20091027/"><cite>OWL 2 Web Ontology Language:Primer.</cite></a> 27 October 2009. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2009/REC-owl2-primer-20091027/">http://www.w3.org/TR/2009/REC-owl2-primer-20091027/</a>
 </dd><dt id="bib-RDF-CONCEPTS">[RDF-CONCEPTS]</dt><dd>Graham Klyne; Jeremy J. Carroll. <a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210"><cite>Resource Description Framework (RDF): Concepts and Abstract Syntax.</cite></a> 10 February 2004. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2004/REC-rdf-concepts-20040210">http://www.w3.org/TR/2004/REC-rdf-concepts-20040210</a>
 </dd><dt id="bib-RDF-MT">[RDF-MT]</dt><dd>Patrick Hayes. <a href="http://www.w3.org/TR/2004/REC-rdf-mt-20040210"><cite>RDF Semantics.</cite></a> 10 February 2004. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2004/REC-rdf-mt-20040210">http://www.w3.org/TR/2004/REC-rdf-mt-20040210</a>
 </dd><dt id="bib-RDF-PRIMER">[RDF-PRIMER]</dt><dd>Frank Manola; Eric Miller. <a href="http://www.w3.org/TR/2004/REC-rdf-primer-20040210/"><cite>RDF Primer.</cite></a> 10 February 2004. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2004/REC-rdf-primer-20040210/">http://www.w3.org/TR/2004/REC-rdf-primer-20040210/</a>
@@ -2890,10 +2920,10 @@
 </dd><dt id="bib-RFC2119">[RFC2119]</dt><dd>S. Bradner. <a href="http://www.ietf.org/rfc/rfc2119.txt"><cite>Key words for use in RFCs to Indicate Requirement Levels.</cite></a> March 1997. Internet RFC 2119.  URL: <a href="http://www.ietf.org/rfc/rfc2119.txt">http://www.ietf.org/rfc/rfc2119.txt</a> 
 </dd><dt id="bib-SKOS-REFERENCE">[SKOS-REFERENCE]</dt><dd>Sean Bechhofer; Alistair Miles. <a href="http://www.w3.org/TR/2009/REC-skos-reference-20090818/"><cite>SKOS Simple Knowledge Organization System Reference.</cite></a> 18 August 2009. W3C Recommendation. URL: <a href="http://www.w3.org/TR/2009/REC-skos-reference-20090818/">http://www.w3.org/TR/2009/REC-skos-reference-20090818/</a>
 </dd><dt id="bib-SPARQL-QUERY-11">[SPARQL-QUERY-11]</dt><dd>Steve Harris; Andy Seaborne. <a href="http://www.w3.org/TR/2012/PR-sparql11-query-20121108/"><cite>SPARQL 1.1 Query Language</cite></a> 8 November 2012. W3C Proposed Recommendation. URL: <a href="http://www.w3.org/TR/2012/PR-sparql11-query-20121108/">http://www.w3.org/TR/2012/PR-sparql11-query-20121108/</a>
-</dd><dt id="bib-SPARQL-UPDATE-11">[SPARQL-UPDATE-11]</dt><dd>Paul Gearon; Alexandre Passant; Axel Polleres. <a href="http://www.w3.org/TR/2012/PR-sparql11-update-20121108/"><cite>SPARQL 1.1 Update</cite></a> W3C Proposed Recommendation. 8 November 2012. URL: <a href="http://www.w3.org/TR/2012/PR-sparql11-update-20121108/">http://www.w3.org/TR/2012/PR-sparql11-update-20121108/</a>
+</dd><dt id="bib-SPARQL-UPDATE-11">[SPARQL-UPDATE-11]</dt><dd>Paul Gearon; Alexandre Passant; Axel Polleres. <a href="http://www.w3.org/TR/2012/PR-sparql11-update-20121108/"><cite>SPARQL 1.1 Update</cite></a> 8 November 2012. W3C Proposed Recommendation. URL: <a href="http://www.w3.org/TR/2012/PR-sparql11-update-20121108/">http://www.w3.org/TR/2012/PR-sparql11-update-20121108/</a>
 </dd><dt id="bib-TURTLE-TR">[TURTLE-TR]</dt><dd>Eric Prud'hommeaux, Gavin Carothers. <a href="http://www.w3.org/TR/2013/CR-turtle-20130219/"><cite>Turtle: Terse RDF Triple Language.</cite></a> 19 February 2013. W3C Candidate Recommendation. URL: <a href="http://www.w3.org/TR/2013/CR-turtle-20130219/">http://www.w3.org/TR/2013/CR-turtle-20130219/</a>
 </dd></dl></section><section id="informative-references"><h3><span class="secno">C.2 </span>Informative references</h3><dl class="bibliography"><dt id="bib-COG">[COG]</dt><dd>SDMX Contnent Oriented Guidelines, <a href="http://sdmx.org/?page_id=11">http://sdmx.org/?page_id=11</a>
-</dd><dt id="bib-DC11">[DC11]</dt><dd>Dublin Core metadata initiative. <a href="http://dublincore.org/documents/dcmi-terms/"><cite>Dublin Core metadata element set, version 1.1.</cite></a> July 1999. Dublin Core recommendation. URL: <a href="http://dublincore.org/documents/dcmi-terms/">http://dublincore.org/documents/dcmi-terms/</a>
+</dd><dt id="bib-DCAT">[DCAT]</dt><dd>Fadi Maali; John Erickson; Phil Archer. <a href="http://www.w3.org/TR/vocab-dcat/"><cite>Data Catalog Vocabulary (DCAT)</cite></a> W3C Working Draft. 12 March 2013. URL: <a href="http://www.w3.org/TR/vocab-dcat/">http://www.w3.org/TR/vocab-dcat/</a>
 </dd><dt id="bib-FOAF">[FOAF]</dt><dd>Dan Brickley, Libby Miller. <a href="http://xmlns.com/foaf/spec/"><cite>FOAF Vocabulary Specification 0.98.</cite></a> 9 August 2010. URL: <a href="http://xmlns.com/foaf/spec/">http://xmlns.com/foaf/spec/</a>
 </dd><dt id="bib-LOD">[LOD]</dt><dd>Linked Data, <a href="http://linkeddata.org/">http://linkeddata.org/</a>
 </dd><dt id="bib-OLAP">[OLAP]</dt><dd>Online Analytical Processing Data Cubes, <a href="http://en.wikipedia.org/wiki/OLAP_cube">http://en.wikipedia.org/wiki/OLAP_cube</a>
--- a/respec/gld-bib.js	Fri Mar 08 13:48:36 2013 +0000
+++ b/respec/gld-bib.js	Fri Mar 08 14:21:02 2013 +0000
@@ -39,8 +39,20 @@
         ],
         "href": "http://www.w3.org/TR/2012/PR-sparql11-update-20121108/",
         "title": "SPARQL 1.1 Update",
-        "date": "W3C Proposed Recommendation",
-        "status": "8 November 2012",
+        "date": "8 November 2012",
+        "status": "W3C Proposed Recommendation",
+        "publisher": "W3C"
+    },
+    "DCAT": {
+        "authors": [
+            "Fadi Maali",
+	    "John Erickson",
+ 	    "Phil Archer"
+        ],
+        "href": "http://www.w3.org/TR/vocab-dcat/",
+        "title": "Data Catalog Vocabulary (DCAT)",
+        "date": "W3C Working Draft",
+        "status": "12 March 2013",
         "publisher": "W3C"
     }