Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/conneg-doc' into conneg-doc
Browse files Browse the repository at this point in the history
  • Loading branch information
Nicholas Car committed Oct 30, 2018
2 parents cbee6be + 916ff2f commit bb73d51
Show file tree
Hide file tree
Showing 2 changed files with 33 additions and 54 deletions.
8 changes: 5 additions & 3 deletions conneg-by-ap/index.html
View file
Expand Up @@ -363,6 +363,7 @@ <h3>list profiles</h3>
<p>
Listing profiles for a resource using HTTP can be done in two ways.
</p>
<div class="issue" data-number="510"></div>
<p>
The first one is to issue an <code>OPTIONS</code> request against the resource. In this case a server implementing
content negotiation by profile SHOULD return a <code>Content-Profile</code> header listing all profiles
Expand Down Expand Up @@ -459,11 +460,12 @@ <h3>list profiles tokens</h3>
</section>
</section>
<section id="qsa">
<h3>Query String Arguments</h3>
<h2>Query String Arguments</h2>
<div class="issue" data-number="511"></div>
<p>
A Query String Argument (QSA) realisation of the Abstract Model is presented here. Unlike the HTTP realisation
which is the subject of an independent document [[PROF-IETF]], this realisation is fully specified here and this
document is considered normative for this realisation.
document is considered normative for this realisation. This realisation does not preclude other QSA specifications for profile and content negotiation.
</p>
<p>
A query string is a part of a URI which assigns values to specified parameters. QSAs are commonly used within
Expand Down Expand Up @@ -547,7 +549,7 @@ <h4>list profiles</h4>
</p>
<!--<p><code>RESOURCE_URI?_profile=list&_mediatype=text/html</code></p>-->
<pre class="example nohighlight" aria-busy="false" aria-live="polite" title="Requesting a list of profiles for a resource by QSA in HTML">
GET /a/resource?_profile=list&_mediatype=text/html
GET /a/resource?_profile=list&amp;_mediatype=text/html
</pre>
</section>
<section id="getresourcebyprofileqsa">
Expand Down
79 changes: 28 additions & 51 deletions dcat/index.html
View file
Expand Up @@ -40,34 +40,6 @@
and the list of all the changes since the previous version of DCAT in the <a href="#changes">Change History</a> section.
</p>


<h3 id="dxwg_family_of_documents">DXWG Family of Documents</h3>

<p>
This document is part of the output of the Dataset Exchange Working Group (DXWG).
All documents from the group are listed here.
</p>

<h4 id="dcat_documents">DCAT documents</h4>
<p>
The DCAT documents are about the revised Data Catalog Vocabulary.
</p>
<ul>
<li>[VOCAB-DCAT] (Recommendation) - this document, description of the DCAT RDF vocabulary</li>
</ul>

<h4 id="profiling_documents">Profiling documents</h4>
<p>
These documents give guidance on profiling. Some of the documents are general while some are technology-specific.
Please consult the Profile Guidance [[PROF-GUIDE]] document for an overview of all profiling documents. It is the
recommended starting point.
</p>
<ul>
<li>[[PROF-GUIDE]] (Recommendation) - the top-level general profiling guidance document giving an overview of all other documents</li>
<li>[[PROF-CONNEG]] (Recommendation) - Specific guidance on how to negotiate for Internet resource content using profiles</li>
<li>[[PROF-IETF]] (<a href="http://www.ietf.org">IETF</a> <a href="http://www.ietf.org/standards/ids/">Internet-Draft</a>) - HTTP Headers for HTTP content negotiation by profile</li>
</ul>

<h3 id="dcat_history">DCAT history</h3>
<p>The original DCAT vocabulary (originally hosted at http://vocab.deri.ie/dcat) was developed at the Digital Enterprise Research Institute (DERI), refined by the <a href="http://www.w3.org/egov/">eGov Interest Group</a>, and then finally standardized in 2014 [[VOCAB-DCAT-20140116]] by the <a href="http://www.w3.org/2011/gld/">Government Linked Data (GLD)</a> Working Group.</p>
<p>This revised version of DCAT was developed by the <a href="https://www.w3.org/2017/dxwg/">Dataset Exchange Working Group</a> in response to a new set of Use Cases and Requirements [[DCAT-UCR]] submitted on the basis of experience with the DCAT vocabulary from the time of the original version, and new applications not originally considered. A summary of the changes from [[VOCAB-DCAT-20140116]] can be found at <a href="#changes">Change History</a></p>
Expand Down Expand Up @@ -552,7 +524,6 @@ <h3>Class: Catalog</h3>
<a href="#Property:catalog_themes">themes</a>
</p>
<p>The following properties are inherited from the super-class <a href="http://www.w3.org/ns/dcat#Dataset">dcat:Dataset</a>:
<a href="#Property:dataset_creator">creator</a>,
<a href="#Property:dataset_distribution">distribution</a>,
<a href="#Property:dataset_frequency">frequency</a>,
<a href="#Property:catalog_spatial">spatial/geographic coverage</a>,
Expand All @@ -562,6 +533,7 @@ <h3>Class: Catalog</h3>
<p>The following properties are inherited from the super-class <a href="http://www.w3.org/ns/dcat#Resource">dcat:Resource</a>:
<a href="#Property:resource_conformsto">conformsTo</a>,
<a href="#Property:resource_contact_point">contact point</a>,
<a href="#Property:resource_creator">creator</a>,
<a href="#Property:catalog_description">description</a>,
<a href="#Property:resource_identifier">identifier</a>,
<a href="#Property:resource_keyword">keyword/tag</a>,
Expand Down Expand Up @@ -847,6 +819,7 @@ <h3>Class: Catalogued Resource</h3>
<p>The following properties are recommended for use on this class:
<a href="#Property:resource_conformsto">conformsTo</a>,
<a href="#Property:resource_contact_point">contact point</a>,
<a href="#Property:resource_creator">creator</a>,
<a href="#Property:resource_description">description</a>,
<a href="#Property:resource_identifier">identifier</a>,
<a href="#Property:resource_keyword">keyword/tag</a>,
Expand Down Expand Up @@ -919,6 +892,28 @@ <h4>Property: description</h4>
</table>
</section>

<section id="Property:resource_creator">
<h4>Property: resource creator</h4>

<p class="note">
New property added in this revision of DCAT, specifically added when considering the data citation requirement and
added to the dcat:Resource class, as the Dataset superclass.
</p>


<table class="definition">
<thead><tr><th>RDF Property:</th><th><a href="http://purl.org/dc/terms/creator">dct:creator</a></th></tr></thead>
<tbody>
<tr><td class="prop">Definition:</td><td>The entity responsible for producing the resource.</td></tr>
<tr><td class="prop">Range:</td><td><a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a></td></tr>
<tr><td class="prop">Usage note:</td><td>Resources of type <a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a>
are recommended as values for this property.</td></tr>
<tr><td class="prop">See also:</td><td><a href="#Class:Organization_Person">Class: Organization/Person</a></td></tr>
</tbody>
</table>

</section>

<section id="Property:resource_release_date">
<h4>Property: release date</h4>
<table class="definition">
Expand Down Expand Up @@ -1283,7 +1278,6 @@ <h4>Property: primary topic</h4>
<section id="Class:Dataset">
<h3>Class: Dataset</h3>
<p>The following properties are recommended for use on this class:
<a href="#Property:dataset_creator">creator</a>,
<a href="#Property:dataset_distribution">distribution</a>,
<a href="#Property:dataset_frequency">frequency</a>,
<a href="#Property:dataset_spatial">spatial/geographic coverage</a>,
Expand All @@ -1293,6 +1287,7 @@ <h3>Class: Dataset</h3>
<p>The following properties are are inherited from the super-class <a href="http://www.w3.org/ns/dcat#Resource">dcat:Resource</a>:
<a href="#Property:resource_conformsto">conformsTo</a>,
<a href="#Property:resource_contact_point">contact point</a>,
<a href="#Property:resource_creator">creator</a>,
<a href="#Property:resource_description">description</a>,
<a href="#Property:resource_identifier">identifier</a>,
<a href="#Property:resource_keyword">keyword/tag</a>,
Expand Down Expand Up @@ -1377,27 +1372,6 @@ <h3>Class: Dataset</h3>
</div>


<section id="Property:dataset_creator">
<h4>Property: dataset creator</h4>

<p class="note">
New property for Dataset in this revision of DCAT, added when considering the data citation requirement.
</p>


<table class="definition">
<thead><tr><th>RDF Property:</th><th><a href="http://purl.org/dc/terms/creator">dct:creator</a></th></tr></thead>
<tbody>
<tr><td class="prop">Definition:</td><td>The entity responsible for producing the dataset.</td></tr>
<tr><td class="prop">Range:</td><td><a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a></td></tr>
<tr><td class="prop">Usage note:</td><td>Resources of type <a href="http://xmlns.com/foaf/0.1/Agent">foaf:Agent</a>
are recommended as values for this property.</td></tr>
<tr><td class="prop">See also:</td><td><a href="#Class:Organization_Person">Class: Organization/Person</a></td></tr>
</tbody>
</table>

</section>

<section id="Property:dataset_distribution">
<h4>Property: dataset distribution</h4>

Expand Down Expand Up @@ -1799,6 +1773,7 @@ <h3>Class: Data Service</h3>
<p>The following properties are are inherited from the super-class <a href="http://www.w3.org/ns/dcat#Resource">dcat:Resource</a>:
<a href="#Property:resource_conformsto">conformsTo</a>,
<a href="#Property:resource_contact_point">contact point</a>,
<a href="#Property:resource_creator">creator</a>,
<a href="#Property:resource_description">description</a>,
<a href="#Property:resource_identifier">identifier</a>,
<a href="#Property:resource_keyword">keyword/tag</a>,
Expand Down Expand Up @@ -1894,6 +1869,7 @@ <h3>Class: Data Distribution Service</h3>
<p>The following properties are are inherited from the super-class <a href="http://www.w3.org/ns/dcat#Resource">dcat:Resource</a>:
<a href="#Property:resource_conformsto">conformsTo</a>,
<a href="#Property:resource_contact_point">contact point</a>,
<a href="#Property:resource_creator">creator</a>,
<a href="#Property:resource_description">description</a>,
<a href="#Property:resource_identifier">identifier</a>,
<a href="#Property:resource_keyword">keyword/tag</a>,
Expand Down Expand Up @@ -1942,6 +1918,7 @@ <h3>Class: Discovery Service</h3>
<p>The following properties are are inherited from the super-class <a href="http://www.w3.org/ns/dcat#Resource">dcat:Resource</a>:
<a href="#Property:resource_conformsto">conformsTo</a>,
<a href="#Property:resource_contact_point">contact point</a>,
<a href="#Property:resource_creator">creator</a>,
<a href="#Property:resource_description">description</a>,
<a href="#Property:resource_identifier">identifier</a>,
<a href="#Property:resource_keyword">keyword/tag</a>,
Expand Down

0 comments on commit bb73d51

Please sign in to comment.