Skip to content

Commit

Permalink
Merge branch 'gh-pages' into nick-refs
Browse files Browse the repository at this point in the history
  • Loading branch information
Nicholas Car committed Dec 15, 2018
2 parents 4a9b404 + cd14e17 commit ff8e4d2
Show file tree
Hide file tree
Showing 5 changed files with 90 additions and 73 deletions.
57 changes: 29 additions & 28 deletions conneg-by-ap/config.js
View file
Expand Up @@ -42,47 +42,48 @@ var respecConfig = {
issueBase: "https://github.com/w3c/dxwg/issues/",
github: "https://github.com/w3c/dxwg/",
localBiblio: {
"PROF-ONT": {
"DX-PROF-CONNEG": {
editors: [
"Lars G. Svensson",
"Rob Atkinson",
"Nicholas J. Car"
],
href: "https://w3c.github.io/dxwg/profilesont/",
title: "Profile Descriptions ontology",
date: "2018-09-23",
status: "W3C Editor's Draft"
},
"PROF-CONNEG": {
editors: [
"Lars G. Svensson",
"Rob Atkinson",
"Nicholas J. Car"
],
href: "https://w3c.github.io/dxwg/conneg-by-ap/",
href: "https://www.w3.org/TR/2018/WD-dx-prof-conneg-20181218/",
title: "Content Negotiation by Profile",
date: "2018-12-31",
status: "W3C Editor's Draft"
date: " 2018-12-18",
status: "W3C First Public Working Draft"
},
"PROF-GUIDANCE": {
editors: [
"Rob Atkinson",
"Karen Coyle",
"Antoine Isaac"
],
href: "https://w3c.github.io/dxwg/profiles/",
"DX-PROF-GUIDANCE": {
editors: [
"Rob Atkinson",
"Karen Coyle",
"Antoine Isaac",
"Nicholas J. Car"
],
href: "https://www.w3.org/TR/profile-guidance/",
title: "Profile Guidance",
date: "2018-12-31",
date: " 2018-12-31",
status: "W3C Editor's Draft"
},
"PROF-IETF": {
"DX-PROF-IETF": {
authors: [
"Lars G. Svensson",
"Ruben Verborgh"
"L. Svensson",
"R. Verborgh"
],
href: "https://profilenegotiation.github.io/I-D-Accept--Schema/I-D-accept-schema",
href: "https://profilenegotiation.github.io/I-D-Accept--Schema/I-D-accept-schema/",
title: "Negotiating Profiles in HTTP",
date: "2017-10-24",
date: " 2017-10-24",
status: "IETF Internet Draft"
},
"DX-PROF": {
editors: [
"Rob Atkinson",
"Nicholas J. Car"
],
href: "https://www.w3.org/TR/2018/WD-dx-prof-20181218/",
title: "Profile Descriptions ontology",
date: "2018-12-18",
status: "W3C First Public Working Draft"
}
}
};
43 changes: 20 additions & 23 deletions conneg-by-ap/index.html
View file
Expand Up @@ -24,14 +24,11 @@ <h3>Overview of DXWG documents on profiles</h3>
Some of the documents are general while some are technology-specific:
</p>
<ul>
<li>[[PROF-GUIDANCE]] the top-level general profiling guidance document giving an overview of all other documents</li>
<li>[[PROF-ONT]] a document describing a formal ontology for describing objects related to profiles</li>
<li><strong>[PROF-CONNEG] this document, including specific guidance on how to negotiate for Internet resource content using profiles</strong></li>
<li>[[PROF-IETF]] an
<a href="http://www.ietf.org">Internet Engineering Task Force (<abbr title="Internet Engineering Task Force">IETF</abbr>)</a>
<a href="http://www.ietf.org/standards/ids/">Internet-Draft</a>
defining two Hypertext Transfer Protocol (HTTP) Headers
for HTTP content negotiation by profile</li>
<li>[[DX-PROF-GUIDANCE]] the top-level general recommendations and guidance on profiling.
It gives an overview of all DXWG documents on profiles and is the recommended starting point</li>
<li>[[DX-PROF]] an RDF vocabulary that describes profiles and related resources</li>
<li><strong>[DX-PROF-CONNEG] this document, specific guidance on how to negotiate for Internet resource content using profiles</strong></li>
<li>[[DX-PROF-IETF]] an <a href="http://www.ietf.org">IETF</a> <a href="http://www.ietf.org/standards/ids/">Internet-Draft</a> defining HTTP Headers for HTTP content negotiation by profile</li>
</ul>
</section>
</section>
Expand Down Expand Up @@ -69,12 +66,12 @@ <h1>Introduction</h1>
of content negotiation and ensures they all adhere to a single functional specification, ensuring their functional equivalency.
</p>
<p>
Guidance for the creation of <a>profile</a>s is provided in the [[PROF-GUIDANCE]] document created
Guidance for the creation of <a>profile</a>s is provided in the [[DX-PROF-GUIDANCE]] document created
by the Dataset Exchange Working Group (DXWG).
</p>
<p>
Describing the parts of profiles and their relation to other profiles is the function of the Profiles Ontology
[[PROF-ONT]], also produced by the DXWG.
[[DX-PROF]], also produced by the DXWG.
</p>
</section>
<section id="conformance">
Expand Down Expand Up @@ -167,7 +164,7 @@ <h2>Related Work</h2>
<p>
The standardization of the content-negotiation HTTP headers is the purview of the IETF. A first proposal
for an <a href="https://profilenegotiation.github.io/I-D-Accept--Schema/I-D-accept-schema">Internet Draft
for Negotiating Profiles in HTTP</a> [[PROF-IETF]] is available but has not yet been submitted to the IETF. The
for Negotiating Profiles in HTTP</a> [[DX-PROF-IETF]] is available but has not yet been submitted to the IETF. The
current version of the IETF draft (-00) is expected to be completely re-written in parallel work with this document and should
not be seen as anything but work-in-progress.
</p>
Expand Down Expand Up @@ -343,7 +340,7 @@ <h3>Hypertext Transfer Protocol Headers</h3>
A realization of the Abstract Model using Hypertext Transfer Protocol (HTTP) headers is presented here.
This implementation is based on HTTP content negotiation and uses two new HTTP headers,
<code>Accept-Profile</code> and <code>Content-Profile</code>
that are to be defined in an upcoming Internet-Draft [[PROF-IETF]].
that are to be defined in an upcoming Internet-Draft [[DX-PROF-IETF]].
</p>
<div class="issue" data-number="500"></div>
<section id="listprofileshttp">
Expand Down Expand Up @@ -477,7 +474,7 @@ <h2>URI Query String Arguments</h2>
<p>
A Query String Argument (QSA) realization of the <a href="#abstractmodel">Abstract Model</a>
is presented here. Unlike the HTTP realization,
which is the subject of an independent document [[PROF-IETF]],
which is the subject of an independent document [[DX-PROF-IETF]],
this realization is fully specified here
and this document is considered normative for the QSA realization.
This realization does not preclude other QSA specifications for profile and content negotiation.
Expand Down Expand Up @@ -687,7 +684,7 @@ <h2>Requirements</h2>
specific solution should not be any different from the general case.
</p>
<div class="note" title="">Profile definition and constraints on properties are not addressed here. See
[[PROF-GUIDANCE]].</div>
[[DX-PROF-GUIDANCE]].</div>
<p>
This requirement is taken to mean "create a way to list the profiles implemented by a Internet resource for
<em>humans</em> and <em>machines</em> to use". For the former (humans), the options are:
Expand All @@ -696,7 +693,7 @@ <h2>Requirements</h2>
<li>
discovery via HTML representation
<ul>
<li>see [[PROF-GUIDANCE]]</li>
<li>see [[DX-PROF-GUIDANCE]]</li>
<li>an approach suggested is to provide an <em>alternate view</em> resource for the original
resource located at <code>RESOURCE_URI + ?_view=alternates</code> which lists, at a minimum, the
<em>profiles</em>, <em>media types</em> (formats) &amp; <em>languages</em> available, as per the
Expand All @@ -711,14 +708,14 @@ <h2>Requirements</h2>
<li>
discovery via HTTP
<ul>
<li>see [[PROF-IETF]]</li>
<li>see [[DX-PROF-IETF]]</li>
<li>HTTP mechanics are described that allow clients to negotiate with servers for profile listings</li>
</ul>
</li>
<li>
discovery via RDF graph
<ul>
<li>see [[PROF-ONT]]</li>
<li>see [[DX-PROF]]</li>
</ul>
</li>
</ul>
Expand All @@ -728,7 +725,7 @@ <h2>Requirements</h2>
<div class="req-response">
<p class="respTitle">RESPONSE FOR Req. 74</p>
<p>
This requirement is the focus of the IETF RFC in the DXWG Family of Documents [[PROF-IETF]].
This requirement is the focus of the IETF RFC in the DXWG Family of Documents [[DX-PROF-IETF]].
</p>
<p>
In summary, a series of new HTTP headers are added to the HTTP specification allowing for HTTP negotiation
Expand Down Expand Up @@ -760,12 +757,12 @@ <h2>Requirements</h2>
<div class="req-response">
<p class="respTitle">RESPONSE FOR Req. 263</p>
<p>
The IETF submission in the DXWG Family of Documents [[PROF-IETF]] does not address content negotiaiton by
The IETF submission in the DXWG Family of Documents [[DX-PROF-IETF]] does not address content negotiaiton by
profile query param patterns: it is limited to HTTP specification-based negotiation only.
</p>
<p>
Recommendations for content negotiation by profile via query param patterns (Query String Arguments) are
given in the Profile Guidance [[PROF-GUIDANCE]] document where an API for this is defined.
given in the Profile Guidance [[DX-PROF-GUIDANCE]] document where an API for this is defined.
</p>
</div>
<div class="issue" data-number="264"></div>
Expand All @@ -779,7 +776,7 @@ <h2>Requirements</h2>
<div class="req-response">
<p class="respTitle">RESPONSE FOR Req. 265</p>
<p>
This requirement is met by [[PROF-IETF]].
This requirement is met by [[DX-PROF-IETF]].
</p>
</div>
<div class="issue" data-number="266"></div>
Expand Down Expand Up @@ -829,14 +826,14 @@ <h2>Requirements</h2>
<div class="req-response">
<p class="respTitle">RESPONSE FOR Req. 288</p>
<p>
This requirement is met by [[PROF-ONT]].
This requirement is met by [[DX-PROF]].
</p>
</div>
<div class="issue" data-number="289"></div>
<div class="req-response">
<p class="respTitle">RESPONSE FOR Req. 289</p>
<p>
This requirement is met by [[PROF-IETF]].
This requirement is met by [[DX-PROF-IETF]].
</p>
</div>
<div class="issue" data-number="290"></div>
Expand Down
14 changes: 6 additions & 8 deletions profiles/index.html
View file
Expand Up @@ -36,14 +36,12 @@ <h3>Overview of DXWG documents on profiles</h3>
<p>
This document is part of a set of documents on profiles, edited by the W3C Dataset Exchange Working Group (DXWG).
Some of the documents are general while some are technology-specific:
<ul>
<li><strong>[DX-PROF-GUIDANCE] (this document), the top-level general recommendations and guidance on profiling.
It gives an overview of all DXWG documents on profiles and is the recommended starting point</strong></li>
<li>[[DX-PROF]], an RDF vocabulary that enables the description of profiles and related resources</li>
<li>[[DX-PROF-CONNEG]], the specific guidance on how to negotiate for Internet resource content using profiles</li>
<li>[[DX-PROF-IETF]], an <a href="http://www.ietf.org">IETF</a> <a href="http://www.ietf.org/standards/ids/">Internet-Draft</a>
defining HTTP Headers for HTTP content negotiation by profile</li>
</ul>
<ul>
<li><strong>[[DX-PROF-GUIDANCE]] this document, the top-level general recommendations and guidance on profiling. It gives an overview of all DXWG documents on profiles and is the recommended starting point</strong></li>
<li>[[DX-PROF]] an RDF vocabulary that describes profiles and related resources</li>
<li>[DX-PROF-CONNEG] specific guidance on how to negotiate for Internet resource content using profiles</li>
<li>[[DX-PROF-IETF]] an <a href="http://www.ietf.org">IETF</a> <a href="http://www.ietf.org/standards/ids/">Internet-Draft</a> defining HTTP Headers for HTTP content negotiation by profile</li>
</ul>
</section>
</section>

Expand Down
39 changes: 30 additions & 9 deletions profilesont/config.js
View file
Expand Up @@ -78,28 +78,49 @@ var respecConfig = {
date: "2018-09-06",
status: "W3C Community Group Draft Report"
},
"PROF-CONNEG": {
href: "https://www.w3.org/TR/2018/WD-dx-prof-conneg-20181211/",
"DX-PROF-CONNEG": {
editors: [
"Lars G. Svensson",
"Rob Atkinson",
"Nicholas J. Car"
],
href: "https://www.w3.org/TR/2018/WD-dx-prof-conneg-20181218/",
title: "Content Negotiation by Profile",
date: "2018-12-11",
status: "First Public Editor's Draft"
date: " 2018-12-18",
status: "W3C First Public Working Draft"
},
"PROF-GUIDANCE": {
href: "https://w3c.github.io/dxwg/profiles/",
"DX-PROF-GUIDANCE": {
editors: [
"Rob Atkinson",
"Karen Coyle",
"Antoine Isaac",
"Nicholas J. Car"
],
href: "https://www.w3.org/TR/profile-guidance/",
title: "Profile Guidance",
date: " 2018-12-31",
status: "W3C Editor's Draft"
},
"PROF-IETF": {
"DX-PROF-IETF": {
authors: [
"L. Svensson",
"R. Verborgh"
],
href: "https://profilenegotiation.github.io/I-D-Accept--Schema/I-D-accept-schema",
href: "https://profilenegotiation.github.io/I-D-Accept--Schema/I-D-accept-schema/",
title: "Negotiating Profiles in HTTP",
date: "2017-10-24",
date: " 2017-10-24",
status: "IETF Internet Draft"
},
"DX-PROF": {
editors: [
"Rob Atkinson",
"Nicholas J. Car"
],
href: "https://www.w3.org/TR/2018/WD-dx-prof-20181218/",
title: "Profile Descriptions ontology",
date: "2018-12-18",
status: "W3C First Public Working Draft"
},
SCHEMATRON: {
href: "https://www.iso.org/standard/55982.html",
title: "ISO/IEC 19757-3:2016 Information technology -- Document Schema Definition Languages (DSDL) -- Part 3: Rule-based validation -- Schematron",
Expand Down
10 changes: 5 additions & 5 deletions profilesont/index.html
View file
Expand Up @@ -26,11 +26,11 @@ <h3>Overview of DXWG documents on profiles</h3>
This document is part of a set of documents on profiles, edited by the W3C Dataset Exchange Working Group (DXWG).
Some of the documents are general while some are technology-specific:
<ul>
<li>[[PROF-GUIDANCE]], the top-level general recommendations and guidance on profiling.
<li>[[DX-PROF-GUIDANCE]] the top-level general recommendations and guidance on profiling.
It gives an overview of all DXWG documents on profiles and is the recommended starting point</li>
<li><strong>[PROF-ONT] (this document), an RDF vocabulary that describes profiles and related resources</strong></li>
<li>[[PROF-CONNEG]], the specific guidance on how to negotiate for Internet resource content using profiles</li>
<li>[[PROF-IETF]], an <a href="http://www.ietf.org">IETF</a> <a href="http://www.ietf.org/standards/ids/">Internet-Draft</a> defining HTTP Headers for HTTP content negotiation by profile</li>
<li><strong>[DX-PROF] this document, an RDF vocabulary that describes profiles and related resources</strong></li>
<li>[[DX-PROF-CONNEG]] the specific guidance on how to negotiate for Internet resource content using profiles</li>
<li>[[DX-PROF-IETF]] an <a href="http://www.ietf.org">IETF</a> <a href="http://www.ietf.org/standards/ids/">Internet-Draft</a> defining HTTP Headers for HTTP content negotiation by profile</li>
</ul>
</p>
</section>
Expand Down Expand Up @@ -174,7 +174,7 @@ <h2>Motivation</h2>
<div class="issue" data-number="551"></div>
<div class="note" title="See the Content Negotiation by Profile document">
The details of profile negotiation using this ontology, as suggested immediately above, and other methods,
are explained in detail in the related [[PROF-CONNEG]] document.
are explained in detail in the related [[DX-PROF-CONNEG]] document.
</div>
</section>
<section id="relatedwork" class="informative">
Expand Down

0 comments on commit ff8e4d2

Please sign in to comment.