Remove unnecessary repetition in section Compact IRIs
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Wed, 16 May 2012 19:40:19 +0800
changeset 648 67f79866ebe0
parent 647 31b8068735f1
child 649 545ef06895a7
Remove unnecessary repetition in section Compact IRIs
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Wed May 16 19:26:31 2012 +0800
+++ b/spec/latest/json-ld-syntax/index.html	Wed May 16 19:40:19 2012 +0800
@@ -1332,10 +1332,9 @@
     the concept of a <tref>compact IRI</tref> is introduced.</p>
   <p>
     A <tdef>compact IRI</tdef> is a way of expressing an <tref>IRI</tref>
-    using a <em>prefix</em> and <em>suffix</em>.
-    Generally, these prefixes are used by concatenating the <em>prefix</em> and
-    a <em>suffix</em>, which is separated by a colon (<code>:</code>).
-    The <tdef>prefix</tdef> is a <tref>term</tref> taken from the
+    using a <em>prefix</em> and <em>suffix</em> separated by a colon (<code>:</code>) which is
+    similar to the <cite><a href="http://www.w3.org/TR/rdfa-core/#s_curies">CURIE Syntax</a></cite>
+    in [[RDFA-CORE]]. The <tdef>prefix</tdef> is a <tref>term</tref> taken from the
     <tref>active context</tref> and is a short string identifying a
     particular <tref>IRI</tref> in a JSON-LD document.
     For example, the prefix <code>foaf</code> may be used as a short
@@ -1360,24 +1359,6 @@
     (<code>_</code>), the IRI remains unchanged. This effectively means that every term
     containing a colon will be interpreted by a JSON-LD processor as an IRI.
   </p>
-  <p>
-    The ability to use <tref title="compact_iri">compact IRIs</tref> reduces the need for developers
-    to declare every <tref>vocabulary</tref> term that they intend to use in
-    the JSON-LD <tref>context</tref>. This reduces stand-alone JSON-LD
-    document serialization size because every <tref>vocabulary</tref> term
-    need not be declared in the embedded context.
-    <tref title="compact_iri">Compact IRIs</tref> also
-    reduces the cognitive load on the developer. It is far easier to
-    remember <code>foaf:name</code> than it is to remember
-    <code>http://xmlns.com/foaf/0.1/name</code>. The use of prefixes also
-    ensures that a <tref>context</tref> document does not have to be updated
-    in lock-step with an externally defined <tref>vocabulary</tref>.
-    Without prefixes, a developer would need to keep their application
-    context terms in lock-step with an externally defined vocabulary. Rather,
-    by just declaring the <tref>vocabulary</tref> prefix, one can use new
-    terms as they're declared without having to update the application's
-    JSON-LD <tref>context</tref>.
-  </p>
   <p>Consider the following example:</p>
   <pre class="example" data-transform="updateExample">
 <!--
@@ -1431,14 +1412,6 @@
 }
 -->
   </pre>
-  <p>
-    <tref title="compact_iri">Compact IRIs</tref>, also known as CURIEs, are defined more formally in RDFa Core 1.1,
-    <cite><a href="http://www.w3.org/TR/rdfa-core/#s_curies">Section 6
-    &quot;CURIE Syntax Definition&quot;</a></cite> [[RDFA-CORE]].
-    JSON-LD does not support the square-bracketed CURIE syntax as the
-    mechanism is not required to disambiguate <tref>IRI</tref>s in a JSON-LD
-    document like it is in HTML documents.
-  </p>
 </section>
 
 <section>