Attempting to make the introductory paragraph easier to understand.
authorManu Sporny <msporny@digitalbazaar.com>
Sun, 10 Jun 2012 23:24:17 -0400
changeset 707 0ceff46c4040
parent 706 00aba6ceda52
child 708 5edca967b02e
Attempting to make the introductory paragraph easier to understand.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Sun Jun 10 23:13:39 2012 -0400
+++ b/spec/latest/json-ld-syntax/index.html	Sun Jun 10 23:24:17 2012 -0400
@@ -299,13 +299,17 @@
 JSON, as specified in [[!RFC4627]], is a simple language for representing
 data on the Web. <tref>Linked Data</tref> is a technique for creating a network
 of inter-connected data across different Web documents and Web sites.
-A <em>thing</em> in this data network is typically identified using an
-<tref>IRI</tref> (Internationalized Resource Identifier), which is typically
-dereference-able, and thus may be used to find more information about the
-<em>thing</em>. The <tref>IRI</tref> allows
-a software program to start at one <em>thing</em> and follow links to other
-<em>things</em> in order to learn more about all of the things described on the
-Web.
+A <em>document</em> in this data network is typically identified using an
+<tref>IRI</tref> (Internationalized Resource Identifier). A software program
+can typically follow an IRI just like you follow a URL by putting it into your
+browser's location bar. By following IRIs, a software program can find 
+more information about the <em>document</em> and the <em>thing</em>s that 
+the document describes. 
+These <em>things</em> may also be identified using <tref>IRI</tref>s. The 
+<tref>IRI</tref> allows a software program to start at one 
+<em>document</em> and follow links to other
+<em>documents</em> or <em>things</em> in order to learn more about all of 
+the <em>documents</em> and <em>things</em> described on the Web.
 </p>
 
 <p>