Removed all references to "semantic web". Closes #24.
authorManu Sporny <msporny@digitalbazaar.com>
Sun, 11 Sep 2011 21:19:48 -0400
changeset 204 39184a266ca4
parent 203 99617df9a891
child 205 cedadb230ee6
Removed all references to "semantic web". Closes #24.
spec/latest/index.html
--- a/spec/latest/index.html	Sun Sep 11 21:09:19 2011 -0400
+++ b/spec/latest/index.html	Sun Sep 11 21:19:48 2011 -0400
@@ -545,10 +545,11 @@
 <p>In JSON-LD, a context is used to map <tref>term</tref>s, i.e., keys and values
   in an JSON document, to
   <tref>IRI</tref>s. A <tdef>term</tdef> is a short word that MAY be expanded
-to an <tref>IRI</tref>. The semantic web, just like the document-based
-web, uses IRIs for unambiguous identification. The idea is that these
-<tref>term</tref>
-s mean something that may be of use to other developers.
+to an <tref>IRI</tref>. The Web uses IRIs for unambiguous identification. The 
+idea is that these <tref>term</tref>s mean something that may be of use to 
+other developers and that it is useful to give them an unambiguous identifier.
+That is, it is useful for <tref>term</tref>s to expand to IRIs so that
+developers don't accidentally step on each other's Web Vocabulary terms.
 For example, the term <code>name</code> may map directly to the IRI
 <code>http://xmlns.com/foaf/0.1/name</code>. This allows JSON-LD documents to
 be constructed using the common JSON practice of simple name/value pairs while
@@ -610,13 +611,13 @@
 -->
 </pre>
 
-<p> JSON-LD strives to ensure that developers don't have to change the JSON
+<p>JSON-LD strives to ensure that developers don't have to change the JSON
   that is going into and being returned from their Web APIs. This means
   that developers can also specify a context for JSON data in an out-of-band
   fashion. This is described later in this document. </p>
 
 <p>
-  The semantic web uses a special type of machine-readable document called a
+  JSON-LD uses a special type of machine-readable document called a
   <tdef>Web Vocabulary</tdef> to define <tref>term</tref>s that are then used
   to describe concepts and "things" in the world.
   Typically, these Web Vocabulary documents have <tref>prefix</tref>es associated
@@ -4171,7 +4172,7 @@
 </p>
 
 <ul>
-   <li>RDF - for describing information about objects on the semantic web.</li>
+   <li>RDF - for describing information about objects and concepts on the Web.</li>
    <li>RDFS - for expressing things like labels and comments.</li>
    <li>XSD - for specifying basic types like strings, integers, dates and times.</li>
    <li>Dublin Core - for describing creative works.</li>