Link to relevant section when talking about out-of-band context
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Wed, 16 May 2012 19:21:26 +0800
changeset 646 a8d8359aa84c
parent 645 beddbd1cf987
child 647 31b8068735f1
Link to relevant section when talking about out-of-band context
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Wed May 16 18:48:53 2012 +0800
+++ b/spec/latest/json-ld-syntax/index.html	Wed May 16 19:21:26 2012 +0800
@@ -511,8 +511,9 @@
  linked was an approach that was driven by pragmatism. JSON-LD attempts to be
  more practical than theoretical in its approach to Linked Data.</dd>-->
  <dt>Zero Edits, most of the time</dt>
- <dd>JSON-LD provides a mechanism that allows developers to specify
- <tref>context</tref> in a way that is out-of-band. This allows organizations that have
+ <dd>JSON-LD provides a <a href="#referencing-contexts-from-json-documents">mechanism</a>
+ that allows developers to specify <tref>context</tref> in a way that is out-of-band.
+ This allows organizations that have
  already deployed large JSON-based infrastructure to add meaning to their
  JSON documents in a way that is not disruptive to their day-to-day operations and is
  transparent to their current customers. At times, mapping JSON to
@@ -798,9 +799,9 @@
 -->
 </pre>
 
-<p>In the example above, the key
-<code>http://xmlns.com/foaf/0.1/name</code> is interpreted as an <tref>IRI</tref>, as
-opposed to being interpreted as a string.</p>
+<p>In the example above, the key <code>http://xmlns.com/foaf/0.1/name</code> is interpreted
+  as an <tref>IRI</tref>, as opposed to being interpreted as a string because it contains a colon
+  (<code>:</code>) delimiting a valid IRI scheme.</p>
 
 <p>Term expansion occurs for IRIs if the value matches a <tref>term</tref> defined within the
 <tref>active context</tref>:</p>
@@ -859,8 +860,8 @@
 
 <p class="note">Specifying a <tref>JSON object</tref> with an
   <code>@id</code> key is used to identify that object using an
-  <tref>IRI</tref>. This facility MAY also be used to link a
-  <tref>subject</tref> with an <tref>object</tref> using a mechanism called
+  <tref>IRI</tref>. This facility MAY also be used to link to another
+  <tref>JSON object</tref> using a mechanism called
   <tref>embedding</tref>, which is covered in the section titled
   <a href="#embedding">Embedding</a>.</p>