Add statement in the introduction of the syntax spec that JSON-LD is a serialization for RDF graphs and datasets
This addresses #180.
--- a/spec/latest/json-ld-syntax/index.html Tue Dec 04 22:11:13 2012 +0100
+++ b/spec/latest/json-ld-syntax/index.html Tue Dec 04 22:37:08 2012 +0100
@@ -163,76 +163,70 @@
</section>
<section class="informative">
-<h1>Introduction</h1>
-
-<p><tdef>Linked Data</tdef> is a technique for creating a network
- of inter-connected data across different documents and Web sites. In general,
- Linked Data has four properties: 1) it uses <tref title="IRI">IRIs</tref>
- to name things, 2) it uses HTTP <tref title="IRI">IRIs</tref>
- for those names, 3) the name <tref title="IRI">IRIs</tref>, when dereferenced,
- provide more information about the name, and 4) the data expresses links
- to data on other Web sites. These properties allow data published on the Web
- to work much like Web pages do today. One can start at one piece of Linked Data,
- 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. JSON-LD is
- is 100% compatible with JSON allowing to utilize the large number of JSON parsers
- and libraries available today. Additionally to all the features JSON provides,
- it introduces:</p>
-
-<ul>
- <li>a universal identifier mechanism for <tref title="JSON object">JSON objects</tref> via the
- use of <tref title="IRI">IRIs</tref>,</li>
- <li>a way to disambiguate the keys used between multiple JSON documents
- by mapping them to <tref title="IRI">IRIs</tref> via a <tref>context</tref>,</li>
- <li>a mechanism in which a value in a <tref>JSON object</tref> may refer
- to a <tref>JSON object</tref> on a different site on the Web,</li>
- <li>the ability to express the language associated with a <tref>string</tref></li>
- <li>a way to associate datatypes with values such as dates, times, weights,
- and distances,</li>
- <li>and a facility to express one or more directed graphs, such as a social
- network, in a single document.</li>
-</ul>
-
-<p>Developers that require any of the facilities listed above 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.
- The format is intended to be easy to parse, efficient to generate,
- and can operate inside of devices that contain very little memory.</p>
-
-
-<section>
-<h2>How to Read this Document</h2>
-
-<p>
-This document is a detailed specification for a serialization of Linked
-Data in JSON. The document is primarily intended for the following audiences:
-</p>
-
-<ul>
- <li>Software developers that want to encode Linked Data in a variety of
- programing languages that can use JSON.</li>
- <li>Software developers that want to understand the design decisions and
- language syntax for JSON-LD.</li>
- <li>Software developers that want to implement processors and APIs for
- JSON-LD.</li>
-</ul>
-
-<p>This specification does not describe the programming interfaces for the
-JSON-LD Syntax. The specification that describes the programming interfaces
-for JSON-LD documents is the JSON-LD Application Programming Interface
-[[JSON-LD-API]].</p>
-
-<p>
-To understand the basics in this specification you must first be familiar with
-JSON, which is detailed in [[!RFC4627]].</p>
-
-</section>
-
+ <h1>Introduction</h1>
+
+ <p><tdef>Linked Data</tdef> is a technique for creating a network
+ of inter-connected data across different documents and Web sites. In general,
+ Linked Data has four properties: 1) it uses <tref title="IRI">IRIs</tref>
+ to name things; 2) it uses HTTP <tref title="IRI">IRIs</tref>
+ for those names; 3) the name <tref title="IRI">IRIs</tref>, when dereferenced,
+ provide more information about the name; and 4) the data expresses links
+ to data on other Web sites. These properties allow data published on the Web
+ to work much like Web pages do today. One can start at one piece of Linked Data,
+ 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
+ JSON-LD is 100% compatible with JSON the large number of JSON parsers and libraries
+ available today can be reused. Additionally to all the features JSON provides,
+ JSON-LD introduces:</p>
+
+ <ul>
+ <li>a universal identifier mechanism for <tref title="JSON object">JSON objects</tref> via the
+ use of <tref title="IRI">IRIs</tref>,</li>
+ <li>a way to disambiguate the keys used between multiple JSON documents
+ by mapping them to <tref title="IRI">IRIs</tref> via a <tref>context</tref>,</li>
+ <li>a mechanism in which a value in a <tref>JSON object</tref> may refer
+ to a <tref>JSON object</tref> on a different site on the Web,</li>
+ <li>the ability to express the language associated with a <tref>string</tref></li>
+ <li>a way to associate datatypes with values such as dates, times, weights,
+ and distances,</li>
+ <li>and a facility to express one or more directed graphs, such as a social
+ network, in a single document.</li>
+ </ul>
+
+ <p>Developers that require any of the facilities listed above or need to serialize
+ 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>
+
+ <section>
+ <h2>How to Read this Document</h2>
+
+ <p>This document is a detailed specification for a serialization of Linked
+ Data in JSON. The document is primarily intended for the following audiences:</p>
+
+ <ul>
+ <li>Software developers that want to encode Linked Data in a variety of
+ programing languages that can use JSON.</li>
+ <li>Software developers that want to understand the design decisions and
+ language syntax for JSON-LD.</li>
+ <li>Software developers that want to implement processors and APIs for
+ JSON-LD.</li>
+ </ul>
+
+ <p>This specification does not describe the programming interfaces for the
+ JSON-LD Syntax. The specification that describes the programming interfaces
+ for JSON-LD documents is the JSON-LD Application Programming Interface
+ [[JSON-LD-API]].</p>
+
+ <p>To understand the basics in this specification you must first be familiar with
+ JSON, which is detailed in [[!RFC4627]].</p>
+ </section>
</section>
<section class="informative">