Skip to content

Commit

Permalink
Merge branch 'gh-pages' into dcat-namespace-page
Browse files Browse the repository at this point in the history
  • Loading branch information
davebrowning committed Sep 18, 2019
2 parents 993df0e + ae311c6 commit 33971b0
Showing 1 changed file with 17 additions and 4 deletions.
21 changes: 17 additions & 4 deletions conneg-by-ap/index.html
Expand Up @@ -283,13 +283,13 @@ <h2>Motivation</h2>
</section>
<section id="relatedwork" class="informative">
<h2>Related Work</h2>
<p>
<div class="note">
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-Profile-Negotiation/I-D-Profile-Negotiation">Internet Draft
for Indicating and Negotiating Profiles in HTTP</a> [[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 until this paragraph is removed from this document.
</p>
</div>
<section id="related-http">
<h3>Existing standards for transporting profile information in HTTP headers</h3>
<h4>Using Accept/Content Type together with the profile parameter</h4>
Expand Down Expand Up @@ -840,6 +840,17 @@ <h3>Alternate Representations Data Model</h3>
also given in Functional Profiles of this specification are also given in that appendix.
</p>
</section>
<section id="precendence">
<h3>Order of Precedence for Implementation Profiles</h3>
<p>
It is possible that multiple functional profiles MAY be implemented by a service, including HTTP, QSA and possibly other approaches. In such clases a client MAY specify conflicting choices via different mechanisms. The order of precedence determines which mechanism MUST be used.
</p>
<p>
The order of precedence is QSA over HTTP - on the basis that the more exactly a URI points to a resource, the more likely it is that the agent intends to request that precise resource irrespective of which HTTP headers are sent with that request.
</p>
<p>if other profiles of the abstract model are defined each MUST specify order of precedence.
</p>
</section>
</section>
<section id="functional-profiles">
<h2>Functional Profiles</h2>
Expand Down Expand Up @@ -1210,7 +1221,7 @@ <h3>get resource by profile</h3>
by issuing an <code>HTTP GET</code> request against the resource
and specifying the desired profile URI in an <code>Accept-Profile</code> header.
It is possible to specify a range of acceptable profile URIs
and also to indicate preferences by using quality indicators (q-values). <a href="#eg-http-get"></a> shows a simple
and also to indicate preferences by using quality indicators (q-values) as an ordering mechanism. <a href="#eg-http-get"></a> shows a simple
request for a resource, <code>/resource/a</code>, with a preference for representations according to profiles
identified by the URIs (URNs, in this example) <code>urn:example:profile:x</code> &amp;
<code>urn:example:profile:y</code> with 'q' values indicating a higher preference for the first. A response
Expand Down Expand Up @@ -1338,6 +1349,7 @@ <h5>Key naming</h5>
profile token or URI and SHOULD use <code>_mediatype</code> to indicate a resource representation's Media
Type.
</p>
<div class="note">The recommendation to standardise the use of _mediatype in QSA is <strong>at risk</strong></div>
<p>
When conforming to the profile "QSA Alternate Keywords Functional Profile", any key values acceptable
within the specification of [[RFC3986]] may be used to indicate profile MAY be used, however if this
Expand Down Expand Up @@ -1908,7 +1920,8 @@ <h3>Features at Risk</h3>
</p>
<ul>
<li>Use of <a href="#http">HTTP protocol headers</a>
for information about which profiles the response's message conforms to.
for information about which profiles the response's message conforms to.</li>
<li>Recommendation to use _mediatype to define preferred encoding in QSA implementations.</li>
</ul>
</section>
</section>
Expand Down

0 comments on commit 33971b0

Please sign in to comment.