Merge pull request #454 from json-ld/respec-updates

Respec updates

Author: gkellogg

spec/latest/common/terms.html

@@ -2,7 +2,7 @@
 <section>
   <h1>General Terminology</h1>
   <p>This document uses the following terms as defined in JSON [[!RFC7159]]. Refer
-    to the <em>JSON Grammar</em> section in [[!RFC7159]] for formal definitions.</p>
+    to the <a data-cite="rfc7159#section-2">JSON Grammar section</a> in [[!RFC7159]] for formal definitions.</p>
 
   <dl class="termlist">
     <dt><dfn data-lt="arrays">array</dfn></dt><dd>
@@ -13,15 +13,15 @@ <h1>General Terminology</h1>
       the collection is <em>unordered</em> by default. While order is
       preserved in regular JSON arrays, it is not in regular JSON-LD arrays
       unless specifically defined (see
-      <cite><a href="http://www.w3.org/TR/json-ld/#sets-and-lists" class="externalDFN">Sets and Lists</a></cite> in
+      <a data-cite="JSON-LD#sets-and-lists" class="externalDFN">Sets and Lists</a> in
       the JSON-LD specification [[JSON-LD]]).</dd>
     <dt><dfn data-lt="JSON objects">JSON object</dfn></dt><dd>
       In the JSON serialization, an object structure is represented as a pair of curly brackets surrounding zero or
       more key-value pairs. A key is a <a>string</a>. A single colon comes after
       each key, separating the key from the value. A single comma separates a value
       from a following key. In JSON-LD the keys in an object MUST be unique.
       In the <em>abstract representation</em> a <a>JSON object</a> is equivalent to a
-      <a href="http://www.w3.org/TR/WebIDL/#dfn-dictionary" class="externalDFN"><dfn data-lt="dictionaries">dictionary</dfn></a> (see [[WebIDL-2]]).</dd>
+      <a data-cite="WebIDL#dfn-dictionary" class="externalDFN"><dfn data-lt="dictionaries">dictionary</dfn></a> (see [[WebIDL]]).</dd>
     <dt><dfn>null</dfn></dt><dd>
       The use of the <a>null</a> value within JSON-LD is used to
       ignore or reset values. A key-value pair in the <code>@context</code> where
@@ -37,9 +37,9 @@ <h1>General Terminology</h1>
       that the octal and hexadecimal formats are not used and that leading
       zeros are not allowed.
       In the <em>abstract representation</em>, a <a>number</a> is equivalent to either
-      a <a href="http://www.w3.org/TR/WebIDL/#dfn-long" class="externalDFN">long</a>
-      or <a href="http://www.w3.org/TR/WebIDL/#dfn-double" class="externalDFN">double</a>, depending
-      on if the number has a non-zero fractional part (see [[WebIDL-2]]).</dd>
+      a <a data-cote="WebIDL#idl-long" class="externalDFN">long</a>
+      or <a data-cite="WebIDL#idl-double" class="externalDFN">double</a>, depending
+      on if the number has a non-zero fractional part (see [[WebIDL]]).</dd>
     <dt><dfn>scalar</dfn></dt><dd>
       A scalar is either a JSON <a>string</a>, <a>number</a>, <a>true</a>,
       or <a>false</a>.</dd>
@@ -49,14 +49,14 @@ <h1>General Terminology</h1>
       character is represented as a single character string.</dd>
     <dt><dfn>true</dfn> and <dfn>false</dfn></dt><dd>
       Values that are used to express one of two possible
-      <a href="http://www.w3.org/TR/WebIDL/#idl-boolean" class="externalDFN">boolean</a> states.</dd>
+      <a data-cite="WebIDL#idl-boolean" class="externalDFN">boolean</a> states.</dd>
   </dl>
 
   <p>Furthermore, the following terminology is used throughout this document:</p>
 
   <dl class="termlist">
     <dt><dfn data-lt="absolute IRIs">absolute IRI</dfn></dt><dd>
-      An absolute <a>IRI</a> is defined in [[!RFC3987]] containing a <em>scheme</em> along with a <em>path</em> and
+      An <a data-cite="rfc3987#section-1.3">absolute IRI</a>> is defined in [[!RFC3987]] containing a <em>scheme</em> along with a <em>path</em> and
       optional <em>query</em> and fragment segments.</dd>
     <dt><dfn data-lt="base IRIs">base IRI</dfn></dt><dd>
       The <a>base IRI</a> is an <a>absolute IRI</a> established in the <a>context</a>,
@@ -79,9 +79,9 @@ <h1>General Terminology</h1>
       each IRI contained within a common vocabulary identified by <a>prefix</a>.</dd>
     <dt><dfn data-lt="contexts">context</dfn></dt><dd>
       A a set of rules for interpreting a <a>JSON-LD document</a> as specified in
-      <cite><a href="http://www.w3.org/TR/json-ld/#the-context">The Context</a></cite> of the [[JSON-LD]] specification.</dd>
+      <cite><a data-cite="JSON-LD#the-context">The Context</a> of the [[JSON-LD]] specification.</dd>
     <dt><dfn>datatype IRI</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-datatype-iri" class="externalDFN">datatype IRI</a>
+      A <a data-cite="rdf11-concepts#dfn-datatype-iri" class="externalDFN">datatype IRI</a>
       as specified by [[RDF11-CONCEPTS]].</dd>
     <dt><dfn>default graph</dfn></dt><dd>
       The default graph is the only graph in a JSON-LD document which has no <a>graph name</a>.
@@ -132,7 +132,7 @@ <h1>General Terminology</h1>
         an <a>array</a> of zero or more of the above possibilities.
       </dd>
     <dt><dfn data-lt="IRIs|Internationalized Resource Identifier"><abbr title="Internationalized Resource Identifier">IRI</abbr></dfn></dt><dd>
-      An Internationalized Resource Identifier as described in [[!RFC3987]].</dd>
+      An <a data-cite="rfc3987">Internationalized Resource Identifier</a> as described in [[!RFC3987]].</dd>
     <dt><dfn data-lt="JSON-LD documents">JSON-LD document</dfn></dt><dd>
       A <a>JSON-LD document</a> is a serialization of a collection of
       <a>graphs</a> and comprises exactly one
@@ -143,7 +143,7 @@ <h1>General Terminology</h1>
       <a>language-tagged string</a>.</dd>
     <dt><dfn data-lt="keywords">keyword</dfn></dt><dd>
       A JSON key that is specific to JSON-LD, specified in the JSON-LD Syntax specification [[!JSON-LD]]
-      in the section titled <cite><a href="http://www.w3.org/TR/json-ld/#syntax-tokens-and-keywords">Syntax Tokens and Keywords</a></cite>.</dd>
+      in the section titled <a data-cite="JSON-LD#syntax-tokens-and-keywords">Syntax Tokens and Keywords</a>.</dd>
     <dt><dfn data-lt="language maps">language map</dfn></dt><dd>
       An <a>language map</a> is a <a>JSON object</a> value of a <a>term</a> defined with
       <code>@container</code> set to <code>@language</code>, whose keys MUST be <a>strings</a> representing
@@ -155,17 +155,17 @@ <h1>General Terminology</h1>
     <dt><dfn data-lt="language-tagged strings">language-tagged string</dfn></dt><dd>
       A <a>language-tagged string</a> consists of a string and a non-empty language
       tag as defined by [[!BCP47]]. The language tag MUST be well-formed according to
-      <a href="http://tools.ietf.org/html/bcp47#section-2.2.9">section 2.2.9 Classes of Conformance</a>
+      <a data-cite="bcp47#section-2.2.9">section 2.2.9 Classes of Conformance</a>
       of [[!BCP47]], and is normalized to lowercase.</dd>
     <dt><dfn>Linked Data</dfn></dt><dd>
       A set of documents, each containing a representation of a <a>linked data graph</a>.</dd>
     <dt><dfn data-lt="graph|graphs">linked data graph</dfn></dt><dd>
       A labeled directed graph, i.e., a set of <a>nodes</a>
       connected by <a>edges</a>,
-      as specified in the <cite><a href="http://www.w3.org/TR/json-ld/#data-model">Data Model</a></cite>
+      as specified in the <a data-cite="JSON-LD#data-model">Data Model</a>
       section of the JSON-LD specification [[!JSON-LD]].
       A <a>linked data graph</a> is a generalized representation of a
-      <cite><a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-graph">RDF graph</a></cite>
+      <a data-cite="rdf11-concepts#dfn-rdf-graph">RDF graph</a>
       as defined in [[!RDF-CONCEPTS]].</dd>
     <dt><dfn data-lt="lists">list</dfn></dt><dd>
       A <a>list</a> is an ordered sequence of <a>IRIs</a>,
@@ -184,7 +184,6 @@ <h1>General Terminology</h1>
       A <a>nested property</a> is a <a>property</a> which is contained within an object referenced by
       a semantically meaningless <em>nesting property</em>.
     </dd>
-      (the <a>graph name</a>) and a <a>graph</a>.</dd>
     <dt><dfn data-lt="nodes">node</dfn></dt><dd>
       Every <a>node</a> is an <a>IRI</a>, a <a>blank node</a>,
       a <a>JSON-LD value</a>, or a <a>list</a>.
@@ -216,29 +215,29 @@ <h1>General Terminology</h1>
       A piece of information that contains four items; a <a>subject</a>, a <a>property</a>,
       an <a>object</a>, and a <a>graph name</a>.</dd>
     <dt><dfn>RDF collection</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf-schema/#ch_collectionvocab" class="externalDFN">collection</a>
+      A <a data-cite="rdf-schema#ch_collectionvocab" class="externalDFN">collection</a>
       as specified by [[RDF-SCHEMA]].</dd>
     <dt><dfn>RDF dataset</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-dataset" class="externalDFN">dataset</a>
+      A <a data-cite="rdf11-concepts#dfn-rdf-dataset" class="externalDFN">dataset</a>
       as specified by [[RDF11-CONCEPTS]] representing a collection of
-      <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-graph">RDF graphs</a>.</dd>
+      <a data-cite="rdf11-concepts#dfn-rdf-graph">RDF graphs</a>.</dd>
     <dt><dfn data-lt="RDF literals">RDF literal</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-literal" class="externalDFN">literal</a>
+      A <a data-cite="rdf11-concepts#dfn-literal" class="externalDFN">literal</a>
       as specified by [[RDF11-CONCEPTS]].</dd>
     <dt><dfn>RDF object</dfn></dt><dd>
-      An <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-object" class="externalDFN">object</a>
+      An <a data-cite="rdf11-concepts#dfn-object" class="externalDFN">object</a>
       as specified by [[RDF11-CONCEPTS]].</dd>
-    <dt><dfn data-lt="predicate|RDF predicates">RDF predicate</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-predicate" class="externalDFN">predicate</a>
+    <dt><dfn data-lt="predicate|predicates|RDF predicates">RDF predicate</dfn></dt><dd>
+      A <a data-cite="rdf11-concepts#dfn-predicate" class="externalDFN">predicate</a>
       as specified by [[RDF11-CONCEPTS]].</dd>
     <dt><dfn>RDF resource</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-resource" class="externalDFN">resource</a>
+      A <a data-cite="rdf11-concepts#dfn-resource" class="externalDFN">resource</a>
       as specified by [[RDF11-CONCEPTS]].</dd>
     <dt><dfn>RDF subject</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-subject" class="externalDFN">subject</a>
+      A <a data-cite="rdf11-concepts#dfn-subject" class="externalDFN">subject</a>
       as specified by [[RDF11-CONCEPTS]].</dd>
     <dt><dfn data-lt="triple|triples|RDF triples">RDF triple</dfn></dt><dd>
-      A <a href="http://www.w3.org/TR/rdf11-concepts/#dfn-rdf-triple" class="externalDFN">triple</a>
+      A <a data-cite="rdf11-concepts#dfn-rdf-triple" class="externalDFN">triple</a>
       as specified by [[RDF11-CONCEPTS]].</dd>
     <dt><dfn data-lt="relative IRIs">relative IRI</dfn></dt><dd>
       A relative IRI is an <a>IRI</a> that is relative to some other <a>absolute IRI</a>.</dd>
@@ -265,8 +264,8 @@ <h1>General Terminology</h1>
       are merged with the map value when expanding.</dd>
     <dt><dfn>typed literal</dfn></dt><dd>
       A <a>typed literal</a> is a <a>literal</a> with an associated <a>IRI</a>
-      which indicates the literal's datatype. See <cite><a
-      href="http://www.w3.org/TR/rdf11-concepts/#dfn-typed-literal">languaged-tagged literal</a></cite> in [[!RDF-CONCEPTS]].</dd>
+      which indicates the literal's datatype. See <a
+      data-cite="rdf11-concepts#dfn-typed-literal">languaged-tagged literal</a> in [[!RDF-CONCEPTS]].</dd>
     <dt><dfn data-lt="typed values">typed value</dfn></dt><dd>
       A <a>typed value</a> consists of a value, which is a <a>string</a>, and a type,
       which is an <a>IRI</a>.</dd>
@@ -321,7 +320,7 @@ <h1>Algorithm Terms</h1>
       A <a>JSON-LD Processor</a> is a system which can perform the algorithms defined in [[JSON-LD-API]].</dd>
     <dt><dfn>map of flattened subjects</dfn></dt><dd>
       A map of subjects that is the result of the
-      <a href="https://www.w3.org/TR/json-ld-api/#node-map-generation">Node Map Generation algorithm</a>.</dd>
+      <a data-cite="JSON-LD-API#node-map-generation">Node Map Generation algorithm</a>.</dd>
     <dt><dfn>object embed flag</dfn></dt><dd>
       A flag specifying that <a>node objects</a> should be directly embedded in the output,
       instead of being referred to by their <a>IRI</a>.</dd>
@@ -338,7 +337,7 @@ <h1>Algorithm Terms</h1>
       <a>JSON object</a>.</dd>
     <dt><dfn data-lt="promises">promise</dfn></dt><dd>
       A <em>promise</em> is an object that represents the eventual result of a single asynchronous operation.
-      Promises are defined in [[!promises-guide]].</dd>
+      <a data-cite="ecmascript-6.0#sec-promise-objects">Promises</a> are defined in [[ECMASCRIPT-6.0]].</dd>
     <dt><dfn>require all flag</dfn></dt><dd>
       A flag specifying that all properties present in the <a>input frame</a>
       MUST either have a default value or be present in the <a>JSON-LD