Move introductory paragraph of section JSON-LD Data Model to Introduction
authorMarkus Lanthaler <mark_lanthaler@gmx.net>
Mon, 01 Oct 2012 14:16:14 +0200
changeset 893 167876b4db1a
parent 892 2232a3bd1e07
child 894 fc9384b5d7d5
Move introductory paragraph of section JSON-LD Data Model to Introduction

This addresses #158.
spec/latest/json-ld-syntax/index.html
--- a/spec/latest/json-ld-syntax/index.html	Mon Oct 01 12:46:40 2012 +0200
+++ b/spec/latest/json-ld-syntax/index.html	Mon Oct 01 14:16:14 2012 +0200
@@ -314,42 +314,30 @@
 <section class="informative">
 <h1>Introduction</h1>
 
-<p>
-JSON, as specified in [[!RFC4627]], is a simple language for representing
-data on the Web. <tref>Linked Data</tref> is a technique for creating a network
-of inter-connected data across different Web documents and Web sites.
-A <em>document</em> in this data network is typically identified using an
-<tref>IRI</tref> (Internationalized Resource Identifier). A software program
-can typically follow an IRI just like you follow a URL by putting it into your
-browser's location bar. By following IRIs, a software program can find
-more information about the <em>document</em> and the <em>thing</em>s that
-the document describes.
-These <em>things</em> may also be identified using <tref>IRI</tref>s. The
-<tref>IRI</tref> allows a software program to start at one
-<em>document</em> and follow links to other
-<em>documents</em> or <em>things</em> in order to learn more about all of
-the <em>documents</em> and <em>things</em> described on the Web.
-</p>
-
-<p>
-JSON-LD is designed as a lightweight syntax that can be used to express
-<tref>Linked Data</tref>. It is primarily intended to be a way to use Linked Data
-in Javascript and other Web-based programming environments. It is also
-useful when building inter-operable Web services and when storing Linked
-Data in JSON-based document storage engines. It is practical and designed
-to be as simple as possible, utilizing the large number of JSON parsers
-and libraries available today.
-</p>
-
-<p>
-The syntax does not necessarily require applications to change their JSON, but
-allows one to easily add meaning by simply adding or referencing a context.
-The syntax is designed to not disturb already deployed systems
-running on JSON, but provide a smooth upgrade path from JSON to JSON-LD.
-Finally, the format is intended to be easy to parse, efficient
-to generate, and can operate inside of devices that contain very little
-memory.
-</p>
+<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 <em>things</em>, 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 inter-operable
+  Web services and when storing Linked Data in JSON-based document storage engines.
+  It is practical and designed to be as simple as possible, utilizing the large
+  number of JSON parsers and libraries available today.</p>
+
+<p>The syntax does not necessarily require applications to change their JSON, but
+  allows one to easily add meaning by simply adding or referencing a context.
+  The syntax is designed to not disturb already deployed systems running on JSON,
+  but provide a smooth upgrade path from JSON to JSON-LD. Finally, 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>
@@ -529,21 +517,8 @@
 <section>
 <h2>JSON-LD Data Model</h2>
 
-<p>
-<tdef>Linked Data</tdef> is a way of publishing data on the Web. In general,
-Linked Data has four properties; 1) It uses <tref>IRI</tref>s to name
-<em>things</em>, 2) It uses HTTP <tref>IRI</tref>s for those names, 3) The
-name links, when followed, 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 a way of expressing <tref>Linked Data</tref> on the Web. The
-JSON-LD data model encapsulates the following concepts:
-</p>
+<p>JSON-LD is a way of expressing <tref>Linked Data</tref> on the Web. The
+  JSON-LD data model encapsulates the following concepts:</p>
 
 <ol>
   <li>The JSON-LD data model is used to represent <tref>linked data graph</tref>s.</li>