Improve Abstract and Introduction
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Wed, 20 Mar 2013 15:44:37 +0100
changeset 1459 211abd209cd2
parent 1458 a30424df0a18
child 1460 4401e24529b7
Improve Abstract and Introduction

This addresses #230.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Wed Mar 20 13:25:56 2013 +0100
+++ b/spec/latest/json-ld-syntax/index.html	Wed Mar 20 15:44:37 2013 +0100
@@ -95,11 +95,13 @@
 
 <body>
 <section id="abstract">
-  <p>JSON has proven to be a highly useful object serialization and messaging format.
-    In an attempt to standardize the representation of <tref>Linked Data</tref>
-    in JSON, this specification defines JSON representation format for
-    expressing directed graphs, mixing both Linked Data and non-Linked Data in
-    a single document.</p>
+  <p>JSON has proven to be a highly useful object serialization and messaging
+    format. This specification defines JSON-LD, a JSON-based format to serialize
+    Linked Data. The syntax is designed to not disturb already deployed systems
+    running on JSON, but provide a smooth upgrade path from JSON to JSON-LD.
+    It is primarily intended to be a way to use Linked Data in Web-based
+    programming environments, to build interoperable Web services, and to
+    store Linked Data in JSON-based storage engines.</p>
 </section>
 
 <section id="sotd">
@@ -165,10 +167,11 @@
     and follow the links to other pieces of data that are hosted on different
     sites across the Web.</p>
 
-  <p>JSON-LD is designed as a lightweight syntax to express <tref>Linked Data</tref> in
-    JSON [[!RFC4627]]. It is primarily intended to be a way to use Linked Data in
-    Web-based programming environments. It is also useful when building interoperable
-    Web services and when storing Linked Data in JSON-based storage engines. Since
+  <p>JSON-LD is a lightweight syntax to serialize <tref>Linked Data</tref> in
+    JSON [[!RFC4627]]. Its design allows existing JSON to be transformed to
+    Linked Data with minimal changes. JSON-LD is primarily intended to be a
+    way to use Linked Data in Web-based programming environments, to build
+    interoperable Web services, and to store Linked Data in JSON-based storage engines. Since
     JSON-LD is 100% compatible with JSON, the large number of JSON parsers and libraries
     available today can be reused. In addition to all the features JSON provides,
     JSON-LD introduces:</p>
@@ -190,7 +193,9 @@
     an RDF graph or dataset [[RDF-CONCEPTS]] in a JSON-based syntax will find
     JSON-LD of interest. The syntax is designed to not disturb already deployed
     systems running on JSON, but provide a smooth upgrade path from JSON to
-    JSON-LD.</p>
+    JSON-LD. Since the shape of such data varies wildly, JSON-LD features mechanisms
+    to reshape documents into a deterministic structure which simplifies their
+    processing.</p>
 
   <section>
     <h2>How to Read this Document</h2>
@@ -200,11 +205,12 @@
 
     <ul>
       <li>Software developers who want to encode Linked Data in a variety of
-      programming languages that can use JSON.</li>
+        programming languages that can use JSON.</li>
+      <li>Software developers who want to convert existing JSON to JSON-LD.</li>
       <li>Software developers who want to understand the design decisions and
-      language syntax for JSON-LD.</li>
+        language syntax for JSON-LD.</li>
       <li>Software developers who want to implement processors and APIs for
-      JSON-LD.</li>
+        JSON-LD.</li>
     </ul>
 
     <p>A companion document, the JSON-LD Processing Algorithms and API specification