Merge pull request #158 from w3c/andrea-perego-patch-2

Added ack + changelog sections

dcat/index.html

@@ -34,7 +34,7 @@ <h2>Introduction</h2>
 
 <p class="note">From DCAT 1.0</p>
 
-<p>Data can come in many formats, ranging from spreadsheets, through XML and RDF, to various speciality formats. DCAT does not make any assumptions about the serialisation format of the datasets described in a catalog. Other, complementary vocabularies may be used together with DCAT to provide more detailed format-specific information. For example, properties from the VoID vocabulary [[void]] can be used to express various statistics about a DCAT-described dataset if that dataset is in RDF format.</p>
+<p>Data can come in many formats, ranging from spreadsheets, through XML and RDF, to various speciality formats. DCAT does not make any assumptions about the serialisation format of the datasets described in a catalog. Other, complementary vocabularies may be used together with DCAT to provide more detailed format-specific information. For example, properties from the VoID vocabulary [[VOID]] can be used to express various statistics about a DCAT-described dataset if that dataset is in RDF format.</p>
 <p>This document does not prescribe any particular method of deploying data expressed in DCAT. DCAT is applicable in many contexts including RDF accessible via SPARQL endpoints, embedded in HTML pages as RDFa, or serialized as e.g. RDF/XML or Turtle. The examples in this document use Turtle simply because of Turtle's readability.</p>
 </section>
 
@@ -133,7 +133,7 @@ <h2>Vocabulary Overview</h2>
 		Overview of DCAT model
 	</figcaption>
 </figure>
-<p>All RDF examples in this document are written in Turtle syntax [[turtle]].</p>
+<p>All RDF examples in this document are written in Turtle syntax [[Turtle]].</p>
 <section id="basic-example">
 <h3>Basic Example</h3>
 <p>This example provides a quick overview of how DCAT might be used to represent a government catalog and its datasets. </p>
@@ -176,7 +176,7 @@ <h3>Basic Example</h3>
 </pre>
 
 <p>In order to express the frequency of update in the example above, we chose to use an instance from the <a href="http://www.w3.org/TR/vocab-data-cube/#dsd-cog">Content-Oriented Guidelines</a> developed as part
-of the <abbr title="World Wide Web Consortium">W3C</abbr> Data Cube Vocabulary efforts. Additionally, we chose to describe the spatial and temporal coverage of the example dataset using URIs from <a href="http://www.geonames.org/">Geonames</a> and <a href="http://reference.data.gov.uk/id/interval">the Interval dataset</a> from data.gov.uk, respectively. A contact point is also provided where comments and feedback about the dataset can be sent. Further details about the contact point, such as email address or telephone number, can be provided using vCard [[vcard-rdf]].</p>
+of the <abbr title="World Wide Web Consortium">W3C</abbr> Data Cube Vocabulary efforts. Additionally, we chose to describe the spatial and temporal coverage of the example dataset using URIs from <a href="http://www.geonames.org/">Geonames</a> and <a href="http://reference.data.gov.uk/id/interval">the Interval dataset</a> from data.gov.uk, respectively. A contact point is also provided where comments and feedback about the dataset can be sent. Further details about the contact point, such as email address or telephone number, can be provided using vCard [[VCARD-RDF]].</p>
 
 <p>The dataset distribution :dataset-001-csv can be downloaded as a 5Kb CSV file. This information is
 represented via an RDF resource of type dcat:Distribution.
@@ -347,7 +347,7 @@ <h3>RDF representation</h3>
 <h3>Dependencies</h3>
 
 <p>
-The definitions (including domain and range) of terms outside the dcat namespace are provided here only for convenience and must not be considered normative. The authoritative definitions of these terms are in the corresponding specifications: [[!dc11]], [[!foaf]], [[!rdf-schema]], [[!skos-reference]], [[!xmlschema11-2]] and [[!vcard-rdf]].
+The definitions (including domain and range) of terms outside the dcat namespace are provided here only for convenience and must not be considered normative. The authoritative definitions of these terms are in the corresponding specifications: [[!DC11]], [[!DCTERMS]], [[!FOAF]], [[!RDF-SCHEMA]], [[!SKOS-REFERENCE]], [[!XMLSCHEMA11-2]] and [[!VCARD-RDF]].
 </p>
 
 <p class="note">Description of DCAT vocabulary elements from DCAT 1.0 except where indicated.</p>
@@ -417,7 +417,7 @@ <h4>Property: release date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>Date of formal issuance (e.g., publication) of the catalog.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]
     </td></tr>
     <tr><td class="prop">See also:</td><td><a href="#Property:dataset_release_date" title=""> dataset release date</a>, <a href="#Property:record_release_date" title=""> catalog record listing date</a> and <a href="#Property:distribution_release_date" title=""> distribution release date</a></td></tr>
   </tbody>
@@ -431,7 +431,7 @@ <h4>Property: update/modification date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>Most recent date on which the catalog was changed, updated or modified.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]
     </td></tr>
     <tr><td class="prop">See also:</td><td><a href="#Property:dataset_update_date" title=""> dataset modification date</a>, <a href="#Property:record_update_date" title=""> catalog record modification date</a> and <a href="#Property:distribution_update_date" title=""> distribution modification date</a></td></tr>
   </tbody>
@@ -633,7 +633,7 @@ <h3>Class: Catalog record</h3>
 </table>
 
 
-<p>If a catalog is represented as an RDF Dataset with named graphs (as defined in [[sparql11-query]]),
+<p>If a catalog is represented as an RDF Dataset with named graphs (as defined in [[SPARQL11-QUERY]]),
 then it is appropriate to place the description of each dataset
 (consisting of all RDF triples that mention the dcat:Dataset, dcat:CatalogRecord, and any of its dcat:Distributions)
 into a separate named graph. The name of that graph should be the IRI of the catalog record.
@@ -668,7 +668,7 @@ <h4>Property: listing date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>The date of listing the corresponding dataset in the catalog.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]
      </td></tr>
     <tr><td class="prop">Usage note:</td><td>This indicates the date of listing the dataset in the catalog and not the publication date of the dataset itself.</td></tr>
     <tr><td class="prop">See also:</td><td><a href="#Property:dataset_release_date" title=""> dataset release date</a></td></tr>
@@ -684,7 +684,7 @@ <h4>Property: update/modification date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>Most recent date on which the catalog entry was changed, updated or modified.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]
      </td></tr>
     <tr><td class="prop">Usage note:</td><td>This indicates the date of last change of a catalog entry, i.e. the catalog metadata description of the dataset, and not the date of the dataset itself.</td></tr>
     <tr><td class="prop">See also:</td><td><a href="#Property:dataset_update_date" title=""> dataset modification date</a></td></tr>
@@ -859,7 +859,7 @@ <h4>Property: release date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>Date of formal issuance (e.g., publication) of the dataset.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]
     </td></tr>
     <tr><td class="prop">Usage note:</td><td>This property should be set using the first known date of issuance.</td></tr>
   </tbody>
@@ -873,7 +873,7 @@ <h4>Property: update/modification date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>Most recent date on which the dataset was changed, updated or modified.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]
     </td></tr>
     <tr><td class="prop">Usage note:</td><td>The value of this property indicates a change to the actual dataset, not a change to the catalog record. An absent value may indicate that the dataset has never changed after its initial publication, or that the date of last modification is not known, or that the dataset is continuously updated.</td></tr>
     <tr><td class="prop">See also:</td><td><a href="#Property:dataset_frequency">frequency</a></td></tr>
@@ -1033,7 +1033,7 @@ <h4>Property: type/genre</h4>
 				<a href="http://dublincore.org/documents/dcmi-terms/#section-7">DCMI Type vocabulary</a> [[DCTERMS]]
 			</li>
 			<li>
-				<a href="https://geo-ide.noaa.gov/wiki/index.php?title=ISO_19115_and_19115-2_CodeList_Dictionaries#MD_ScopeCode">ISO 19115 scope codes</a> [[iso-19115-1]]
+				<a href="https://geo-ide.noaa.gov/wiki/index.php?title=ISO_19115_and_19115-2_CodeList_Dictionaries#MD_ScopeCode">ISO 19115 scope codes</a> [[ISO-19115-1]]
 			</li>
 			<li>
 				<a href="https://schema.datacite.org/meta/kernel-4.1/include/datacite-resourceType-v4.1.xsd">Datacite resource types</a> [[DataCite]]
@@ -1082,7 +1082,7 @@ <h4>Property: contact point</h4>
 <table class="definition">
   <thead><tr><th>RDF Property:</th><th><a href="http://www.w3.org/ns/dcat#contactPoint">dcat:contactPoint</a></th></tr></thead>
   <tbody>
-    <tr><td class="prop">Definition:</td><td>Link a dataset to relevant contact information which is provided using VCard [[vcard-rdf]].</td></tr>
+    <tr><td class="prop">Definition:</td><td>Link a dataset to relevant contact information which is provided using vCard [[VCARD-RDF]].</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2006/vcard/ns#Kind">vcard:Kind</a></td></tr>
   </tbody>
 </table>
@@ -1217,7 +1217,7 @@ <h4>Property: release date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>Date of formal issuance (e.g., publication) of the distribution.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]
     </td></tr>
     <tr><td class="prop">Usage note:</td><td>This property should be set using the first known date of issuance.</td></tr>
     <tr><td class="prop">See also:</td><td><a href="#Property:dataset_release_date" title=""> dataset release date</a></td></tr>
@@ -1232,7 +1232,7 @@ <h4>Property: update/modification date</h4>
   <tbody>
     <tr><td class="prop">Definition:</td><td>Most recent date on which the distribution was changed, updated or modified.</td></tr>
     <tr><td class="prop">Range:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal">rdfs:Literal</a>
-    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[xmlschema11-2]]</td></tr>
+    encoded using the relevant <a href="http://www.w3.org/TR/NOTE-datetime">ISO 8601 Date and Time compliant string</a> and typed using the appropriate XML Schema datatype [[XMLSCHEMA11-2]]</td></tr>
     <tr><td class="prop">See also:</td><td><a href="#Property:dataset_update_date" title=""> dataset modification date</a></td></tr>
   </tbody>
 </table>
@@ -1406,7 +1406,7 @@ <h3>Class: Organization/Person</h3>
 <table class="definition">
   <thead><tr><th>RDF Classes:</th><th><a href="http://xmlns.com/foaf/0.1/Person">foaf:Person</a> for people and <a href="http://xmlns.com/foaf/0.1/Organization">foaf:Organization</a> for government agencies or other entities.</th></tr></thead>
   <tbody>
-    <tr><td class="prop">Usage note:</td><td>FOAF [[!foaf]] provides sufficient properties to describe these entities.</td></tr>
+    <tr><td class="prop">Usage note:</td><td>[[!FOAF]] provides sufficient properties to describe these entities.</td></tr>
   </tbody>
 </table>
 </section>
@@ -1429,7 +1429,7 @@ <h2>Alignment with other metadata vocabularies</h2>
 	An alignment of DCAT with HCLS [[HCLS-Dataset]] is being prepared.
 </p>
 <p class="issue" data-number="151">
-	An alignment of DCAT with ISO 19115 [[iso-19115-1]] is being prepared.
+	An alignment of DCAT with ISO 19115 [[ISO-19115-1]] is being prepared.
 </p>
 <p class="issue" data-number="152">
 	An alignment of DCAT with Datacite metadata schema [[DataCite]] is being prepared.
@@ -1453,5 +1453,26 @@ <h2>DCAT Profiles</h2>
   <!-- A list of issues will magically appear here -->
 </section>
 
+    <section class="appendix" id="acknowledgments">
+      <h2>Acknowledgments</h2>
+      <p>The editors gratefully acknowledge the contributions made to this document by <a href="https://www.w3.org/2000/09/dbwg/details?group=99375&public=1">all members of the working group</a><!--; especially, ...-->.</p>
+<!--      
+      <p>The editors would also like to thank comments received from ...</p>
+-->      
+      <p>The editors also gratefully acknowledge the chairs of this Working Group: Karen Coyle, Caroline Burle and Peter Winstanley &mdash; and staff contacts Phil Archer and Dave Raggett.</p>
+    </section>
+
+    <section class="appendix" id="changes">
+      <h2>Change history</h2>
+      <p>A full change-log is available on <a href="https://github.com/w3c/dxwg/commits/gh-pages/dcat">GitHub</a></p>
+      <section id="changes-since-20140116">
+        <h2>Changes since the W3C Recommendation of 16 January 2014</h2>
+        <p>The document has undergone the following changes since the <a href="http://www.w3.org/TR/2014/REC-vocab-dcat-20140116/">W3C Recommendation of 16 January 2014</a>:</p>
+
+        <ul>
+          <li>...</li>
+        </ul>
+      </section>
+
 	</body>
 </html>