Skip to content

Commit 913511d

Browse files
committed
turn into a candidate addition
I didn't follow the pattern 'change_N' for the id, because this change will also be present in json-ld-syntax (in comment/terms), and so will probably require a candidate addition in that spec too (with a different index). Hence the more robust id used here.
1 parent 74e7153 commit 913511d

File tree

2 files changed

+16
-4
lines changed

2 files changed

+16
-4
lines changed

common/terms.html

+3-2
Original file line numberDiff line numberDiff line change
@@ -382,8 +382,9 @@
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>).<br/>
386-
For <a data-cite="JSON-LD11-API#context-processing-algorithms">context processing</a>, <a>term definition</a> values are converted internally to a dedicated data structure that is easier to process.
385+
or a map (<a>expanded term definition</a>).
386+
<ins cite="#change_api_638"><br/>
387+
For <a data-cite="JSON-LD11-API#context-processing-algorithms">context processing</a>, <a>term definition</a> values are converted internally to a dedicated data structure that is easier to process.</ins>
387388
</dd>
388389
<dt class="changed"><dfn data-cite="JSON-LD11#dfn-type-map">type map</dfn></dt><dd class="changed">
389390
A <a>type map</a> is a <a>map</a> value of a <a>term</a>

index.html

+13-2
Original file line numberDiff line numberDiff line change
@@ -1071,10 +1071,19 @@ <h2>RDF Serialization/Deserialization</h2>
10711071
using information provided by the <a>active context</a>. This
10721072
section describes how to produce an <a>active context</a>.</p>
10731073

1074+
<div id="change_api_638" class="candidate correction">
1075+
<span class="marker">Candidate Correction 8</span>
1076+
<p>Change the type of <a>term definition</a> from <a>array</a> to <a>map</a> in <a>active context</a>,
1077+
to be consistent with the way it is used in the algorithms.
1078+
Clarify the notion <a>term definition</a>.
1079+
For more information, refer to <a href="https://github.com/w3c/json-ld-api/issues/630">issue 630</a>.
1080+
</p>
1081+
</div>
1082+
10741083
<p>The <a>active context</a> consists of:</p>
10751084
<ul>
10761085
<li>the active <a>term definitions</a> which specify how
1077-
keys and values have to be interpreted (<a class="changed">map</a> of <a>term definitions</a>),</li>
1086+
keys and values have to be interpreted (<del cite="#change_api_638"><a>array</a></del><ins cite="#change_api_638"><a>map</a></ins> of <a>term definitions</a>),</li>
10781087
<li>the current <dfn data-lt="context-base-iri" data-lt-noDefault>base IRI</dfn> (<a>IRI</a>),</li>
10791088
<li class="changed">the <dfn>original base URL</dfn> (<a>IRI</a>),</li>
10801089
<li class="changed">an <dfn data-lt="context-inverse" data-lt-noDefault>inverse context</dfn> (<a>inverse context</a>),</li>
@@ -1085,7 +1094,7 @@ <h2>RDF Serialization/Deserialization</h2>
10851094
used when a non-propagated <a>context</a> is defined.</li>
10861095
</ul>
10871096

1088-
<p>Each <a>term definition</a><span class="changed">'s value</span> consists of:</p>
1097+
<p>Each <a>term definition</a><ins cite="#change_api_638">'s value</ins> consists of:</p>
10891098
<ul>
10901099
<li>an <dfn>IRI mapping</dfn> (<a>IRI</a>),</li>
10911100
<li class="changed">a <dfn>prefix flag</dfn> (<a>boolean</a>),</li>
@@ -7092,6 +7101,8 @@ <h2>Change log</h2>
70927101
<li>2024-10-31: Abstract JSON serialization from WebIDL interfaces to allow
70937102
for alternative formats,
70947103
as described in <a href="#change_7">Candidate Correction 7</a></li>
7104+
<li>2025-02-28: Clarifiy language about <a>term definitions</a>,
7105+
as described in <a href="#change_api_638">Candidate Correction 8</a></li>
70957106
</ul>
70967107
</details>
70977108

0 commit comments

Comments
 (0)