Permalink
Browse files

Merge expanded-flattened and compacted-flattened profile URIs into fl…

…attened

.. and improve make the text a bit more explicit. See also: http://tools.ietf.org/html/draft-wilde-atom-profile
  • Loading branch information...
1 parent 2f0a6ba commit 18c9a5c0666538ee62fed9b6457d4c2879d0e30b @lanthaler lanthaler committed Apr 5, 2013
Showing with 30 additions and 42 deletions.
  1. +6 −13 ns/json-ld.html
  2. +5 −12 ns/json-ld.jsonld
  3. +19 −17 spec/latest/json-ld/index.html
View
@@ -27,28 +27,21 @@ <h3 property="rdfs:label">JSON-LD context</h3>
<div resource="#expanded">
<h3 property="rdfs:label">Expanded JSON-LD document form</h3>
<p><code>http://www.w3.org/ns/json-ld#expanded</code></p>
- <p property="rdfs:comment">This profile IRI is used to request or specify expanded JSON-LD document form.</p>
- <p>You can read more about this feature in the <a property="rdfs:seeAlso" href="http://www.w3.org/TR/json-ld-syntax/#iana-considerations">JSON-LD Syntax specification</a>.</p>
- <link property="rdfs:isDefinedBy" href="http://www.w3.org/ns/json-ld" />
- </div>
- <div resource="#expanded-flattened">
- <h3 property="rdfs:label">Expanded, flattened JSON-LD document form</h3>
- <p><code>http://www.w3.org/ns/json-ld#expanded-flattened</code></p>
- <p property="rdfs:comment">This profile IRI is used to request or specify expanded, flattened JSON-LD document form.</p>
+ <p property="rdfs:comment">This profile URI is used to request or specify expanded JSON-LD document form.</p>
<p>You can read more about this feature in the <a property="rdfs:seeAlso" href="http://www.w3.org/TR/json-ld-syntax/#iana-considerations">JSON-LD Syntax specification</a>.</p>
<link property="rdfs:isDefinedBy" href="http://www.w3.org/ns/json-ld" />
</div>
<div resource="#compacted">
<h3 property="rdfs:label">Compacted JSON-LD document form</h3>
<p><code>http://www.w3.org/ns/json-ld#compacted</code></p>
- <p property="rdfs:comment">This profile IRI is used to request or specify compacted JSON-LD document form.</p>
+ <p property="rdfs:comment">This profile URI is used to request or specify compacted JSON-LD document form.</p>
<p>You can read more about this feature in the <a property="rdfs:seeAlso" href="http://www.w3.org/TR/json-ld-syntax/#iana-considerations">JSON-LD Syntax specification</a>.</p>
<link property="rdfs:isDefinedBy" href="http://www.w3.org/ns/json-ld" />
</div>
- <div resource="#compacted-flattened">
- <h3 property="rdfs:label">Compacted, flattened JSON-LD document form</h3>
- <p><code>http://www.w3.org/ns/json-ld#compacted-flattened</code></p>
- <p property="rdfs:comment">This profile IRI is used to request or specify compacted, flattened JSON-LD document form.</p>
+ <div resource="#flattened">
+ <h3 property="rdfs:label">Flattened JSON-LD document form</h3>
+ <p><code>http://www.w3.org/ns/json-ld#flattened</code></p>
+ <p property="rdfs:comment">This profile URI is used to request or specify flattened JSON-LD document form.</p>
<p>You can read more about this feature in the <a property="rdfs:seeAlso" href="http://www.w3.org/TR/json-ld-syntax/#iana-considerations">JSON-LD Syntax specification</a>.</p>
<link property="rdfs:isDefinedBy" href="http://www.w3.org/ns/json-ld" />
</div>
View
@@ -25,28 +25,21 @@
{
"@id": "http://www.w3.org/ns/json-ld#expanded",
"label": "Expanded JSON-LD document form",
- "description": "This profile IRI is used to request or specify expanded JSON-LD document form.",
- "seeAlso": "http://www.w3.org/TR/json-ld-syntax/#iana-considerations",
- "isDefinedBy": "http://www.w3.org/ns/json-ld"
- },
- {
- "@id": "http://www.w3.org/ns/json-ld#expanded-flattened",
- "label": "Expanded, flattened JSON-LD document form",
- "description": "This profile IRI is used to request or specify expanded, flattened JSON-LD document form.",
+ "description": "This profile URI is used to request or specify expanded JSON-LD document form.",
"seeAlso": "http://www.w3.org/TR/json-ld-syntax/#iana-considerations",
"isDefinedBy": "http://www.w3.org/ns/json-ld"
},
{
"@id": "http://www.w3.org/ns/json-ld#compacted",
"label": "Compacted JSON-LD document form",
- "description": "This profile IRI is used to request or specify compacted JSON-LD document form.",
+ "description": "This profile URI is used to request or specify compacted JSON-LD document form.",
"seeAlso": "http://www.w3.org/TR/json-ld-syntax/#iana-considerations",
"isDefinedBy": "http://www.w3.org/ns/json-ld"
},
{
- "@id": "http://www.w3.org/ns/json-ld#compacted-flattened",
- "label": "Compacted, flattened JSON-LD document form",
- "description": "This profile IRI is used to request or specify compacted, flattened JSON-LD document form.",
+ "@id": "http://www.w3.org/ns/json-ld#flattened",
+ "label": "Flattened JSON-LD document form",
+ "description": "This profile URI is used to request or specify flattened JSON-LD document form.",
"seeAlso": "http://www.w3.org/TR/json-ld-syntax/#iana-considerations",
"isDefinedBy": "http://www.w3.org/ns/json-ld"
}
@@ -3634,27 +3634,29 @@
<dl>
<dt><code>profile</code></dt>
<dd>
- <p>A whitespace-separated list of IRIs identifying specific constraints
- or conventions that apply to a JSON-LD document. A profile MUST NOT change
- the semantics of the resource representation when processed without profile
- knowledge, so that clients both with and without knowledge of a profiled
- resource can safely use the same representation. The <code>profile</code>
- parameter MAY also be used by clients to express their preferences in the
- content negotiation process. It is RECOMMENDED that profile IRIs are
- dereferenceable and provide useful documentation at that IRI. For more
- information and background please refer to [[RFC6906]].</p>
- <p>This specification defines four values for the <code>profile</code> parameter.
- To request or specify Expanded JSON-LD document form, the IRI
+ <p>A a non-empty list of space-separated URI-encoded URIs identifying specific
+ constraints or conventions that apply to a JSON-LD document according [[RFC6906]].
+ A profile does not change the semantics of the resource representation
+ when processed without profile knowledge, so that clients both with
+ and without knowledge of a profiled resource can safely use the same
+ representation. The <code>profile</code> parameter may be used by
+ clients to express their preferences in the content negotiation process.
+ It is RECOMMENDED that profile URIs are dereferenceable and provide
+ useful documentation at that URI. For more information and background
+ please refer to [[RFC6906]].</p>
+ <p>This specification defines three values for the <code>profile</code> parameter.
+ To request or specify Expanded JSON-LD document form, the URI
<code>http://www.w3.org/ns/json-ld#expanded</code> SHOULD be used.
- To request or specify Expanded, Flattened JSON-LD document form, the IRI
- <code>http://www.w3.org/ns/json-ld#expanded-flattened</code> SHOULD
- be used. To request or specify Compacted JSON-LD document form, the IRI
+ To request or specify Compacted JSON-LD document form, the URI
<code>http://www.w3.org/ns/json-ld#compacted</code> SHOULD be used.
- To request or specify Compacted, Flattened JSON-LD document form, the IRI
- <code>http://www.w3.org/ns/json-ld#compacted-flattened</code> SHOULD be used.
+ To request or specify Flattened JSON-LD document form, the URI
+ <code>http://www.w3.org/ns/json-ld#flattened</code> SHOULD be used.
Please note that, according [[HTTP11]], the value of the <code>profile</code>
parameter has to be enclosed in quotes (<code>"</code>) because it contains
- special characters and, in some cases, whitespace.</p>
+ special characters and, if multiple profiles are combined, whitespace.</p>
+ <p>When processing the "profile" media type parameter, it is important to
+ apply URI-decoding before processing the URI (such as comparing it to
+ known profiles).
</dd>
</dl>
</dd>

0 comments on commit 18c9a5c

Please sign in to comment.