Skip to content

Commit b7b05f3

Browse files
committed
Update terminology "term definition" for CANDIDATE CORRECTION 1.
Relates to w3c/json-ld-api#638.
1 parent 931ebd9 commit b7b05f3

File tree

2 files changed

+15
-2
lines changed

2 files changed

+15
-2
lines changed

common/terms.html

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -383,6 +383,8 @@
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>,
385385
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>
386388
</dd>
387389
<dt class="changed"><dfn data-cite="JSON-LD11#dfn-type-map">type map</dfn></dt><dd class="changed">
388390
A <a>type map</a> is a <a>map</a> value of a <a>term</a>

index.html

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -298,7 +298,7 @@
298298
documents created using the 1.0 version of this specification remain compatible with JSON-LD 1.1.</p>
299299
</section>
300300

301-
<section id="sotd">
301+
<section id="sotd" class="updateable-rec">
302302
<p>This document has been developed by the
303303
<a href="https://www.w3.org/2018/json-ld-wg/">JSON-LD Working Group</a> and was derived from the <a href="https://www.w3.org/community/json-ld/">JSON-LD Community Group's</a> <a href="https://www.w3.org/2018/jsonld-cg-reports/json-ld/">Final Report</a>.</p>
304304

@@ -439,6 +439,15 @@ <h2>Terminology</h2>
439439
<p>This document uses the following terms as defined in external specifications
440440
and defines terms specific to JSON-LD.</p>
441441

442+
443+
<div id="change_api_638" class="candidate correction">
444+
<span class="marker">Candidate Correction 1</span>
445+
<p>Change the type of <a>term definition</a> from <a>array</a> to <a>map</a> in <a>active context</a>,
446+
to be consistent with the way it is used in the algorithms.
447+
For more information, refer to <a href="https://github.com/w3c/json-ld-api/issues/630">issue 630</a>.
448+
</p>
449+
</div>
450+
442451
<div data-include="common/terms.html"></div>
443452
</section>
444453

@@ -3532,7 +3541,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
35323541

35333542
<p class="note">The values of <code>@type</code> are unordered, so if multiple
35343543
types are listed, the order that <a>type-scoped contexts</a> are applied is based on
3535-
<a>code point ordering</a>.</p>
3544+
<a data-lt="code point order">code point ordering</a>.</p>
35363545

35373546
<p>For example, consider the following semantically equivalent examples.
35383547
The first example, shows how properties and types can define their own
@@ -13879,6 +13888,8 @@ <h2>Changes since Recommendation of 16 July 2020</h2>
1387913888
<li>Allow further structured extensions of `application/ld+json` by using
1388013889
`+ld+json` as a structured media extension. See <a href="#structured-extension-ld-json"></a>.</li>
1388113890
<li>Use <a>code point order</a> as a better definition for the more vague "lexicographical order".</li>
13891+
<li>2025-06-04: Clarifiy language about <a>term definitions</a>,
13892+
as described in <a href="#change_api_638">Candidate Correction 1</a></li>
1388213893
</ul>
1388313894
</section>
1388413895

0 commit comments

Comments
 (0)