Skip to content

Commit 5257c91

Browse files
committed
address #630
I'm not entirely satisfied with the addition in common/terms.html, as it seems too detailed for the terminology section. But... ...as pointed out in the comment of #630, the API spec references to this definition in multiple places, and many of those links are actually for instances of the internal representation, *not* for instances of the strings or maps that represent term definition in JSON. So the alternative would be to introduce a new name for those "internal term definition" and patch all the algorithms... which seems laborious and error-prone. @gkellogg I don't remember what's the process for synchronizing the files in common with other specs.
1 parent 55504a9 commit 5257c91

File tree

2 files changed

+4
-3
lines changed

2 files changed

+4
-3
lines changed

common/terms.html

+2-1
Original file line numberDiff line numberDiff line change
@@ -382,7 +382,8 @@
382382
as a key, type, or elsewhere that a string is interpreted as a vocabulary item.
383383
Its value is either a string (<dfn data-cite="JSON-LD11#dfn-simple-term-definition" data-lt="simple term definition|simple term" data-lt-noDefault>simple term definition</dfn>),
384384
expanding to an <a>IRI</a>,
385-
or a map (<a>expanded term definition</a>).
385+
or a map (<a>expanded term definition</a>).<br/>
386+
<span class="change">For <a data-cite="JSON-LD11-API#context-processing-algorithms">context processing</a>, <a>term definitions</a>' values are converted internally to a dedicated data structure</span> that is easier to process.
386387
</dd>
387388
<dt class="changed"><dfn data-cite="JSON-LD11#dfn-type-map">type map</dfn></dt><dd class="changed">
388389
A <a>type map</a> is a <a>map</a> value of a <a>term</a>

index.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -1074,7 +1074,7 @@ <h2>RDF Serialization/Deserialization</h2>
10741074
<p>The <a>active context</a> consists of:</p>
10751075
<ul>
10761076
<li>the active <a>term definitions</a> which specify how
1077-
keys and values have to be interpreted (<a>array</a> of <a>term definitions</a>),</li>
1077+
keys and values have to be interpreted (<a class="change">map</a> of <a>term definitions</a>),</li>
10781078
<li>the current <dfn data-lt="context-base-iri" data-lt-noDefault>base IRI</dfn> (<a>IRI</a>),</li>
10791079
<li class="changed">the <dfn>original base URL</dfn> (<a>IRI</a>),</li>
10801080
<li class="changed">an <dfn data-lt="context-inverse" data-lt-noDefault>inverse context</dfn> (<a>inverse context</a>),</li>
@@ -1085,7 +1085,7 @@ <h2>RDF Serialization/Deserialization</h2>
10851085
used when a non-propagated <a>context</a> is defined.</li>
10861086
</ul>
10871087

1088-
<p>Each <a>term definition</a> consists of:</p>
1088+
<p>Each <a>term definition</a><span class="change">'s value</span> consists of:</p>
10891089
<ul>
10901090
<li>an <dfn>IRI mapping</dfn> (<a>IRI</a>),</li>
10911091
<li class="changed">a <dfn>prefix flag</dfn> (<a>boolean</a>),</li>

0 commit comments

Comments
 (0)