Add statement in the introduction of the syntax spec that JSON-LD is a serialization for RDF graphs and datasets
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Tue, 04 Dec 2012 22:37:08 +0100
changeset 989 3c7ad5946d51
parent 988 88ed02f0cdf1
child 990 a44c5d256b0b
Add statement in the introduction of the syntax spec that JSON-LD is a serialization for RDF graphs and datasets

This addresses #180.
spec/latest/json-ld-syntax/index.html
--- 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)&nbsp;it uses <tref title="IRI">IRIs</tref>
-  to name things, 2)&nbsp;it uses HTTP <tref title="IRI">IRIs</tref>
-  for those names, 3)&nbsp;the name <tref title="IRI">IRIs</tref>, when dereferenced,
-  provide more information about the name, and 4)&nbsp;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)&nbsp;it uses <tref title="IRI">IRIs</tref>
+    to name things; 2)&nbsp;it uses HTTP <tref title="IRI">IRIs</tref>
+    for those names; 3)&nbsp;the name <tref title="IRI">IRIs</tref>, when dereferenced,
+    provide more information about the name; and 4)&nbsp;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">