Merge expanded-flattened and compacted-flattened profile URIs into flattened
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Fri, 05 Apr 2013 16:14:53 +0200
changeset 1552 51ff978dfba9
parent 1551 3e5d8126cf74
child 1553 75bef6e2825e
Merge expanded-flattened and compacted-flattened profile URIs into flattened

.. and improve make the text a bit more explicit. See also: http://tools.ietf.org/html/draft-wilde-atom-profile
ns/json-ld.html
ns/json-ld.jsonld
spec/latest/json-ld/index.html
--- a/ns/json-ld.html	Fri Apr 05 15:55:27 2013 +0200
+++ b/ns/json-ld.html	Fri Apr 05 16:14:53 2013 +0200
@@ -27,28 +27,21 @@
     <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>
--- a/ns/json-ld.jsonld	Fri Apr 05 15:55:27 2013 +0200
+++ b/ns/json-ld.jsonld	Fri Apr 05 16:14:53 2013 +0200
@@ -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"
     }
--- a/spec/latest/json-ld/index.html	Fri Apr 05 15:55:27 2013 +0200
+++ b/spec/latest/json-ld/index.html	Fri Apr 05 16:14:53 2013 +0200
@@ -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>