--- 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