Skip to content

Commit f9675dd

Browse files
davidlehngkellogg
authored andcommitted
Change from "sealed" to "protected".
1 parent 8c01dfd commit f9675dd

File tree

1 file changed

+28
-28
lines changed

1 file changed

+28
-28
lines changed

index.html

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -3311,7 +3311,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
33113311
<a>processing mode</a> set to <code>json-ld-1.1</code>.</p>
33123312
</section>
33133313

3314-
<section class="informative changed"><h2>Sealed Term Definitions</h2>
3314+
<section class="informative changed"><h2>Protected Term Definitions</h2>
33153315
<p>JSON-LD is used in many specifications as the specified data format.
33163316
However, there is also a desire to allow some JSON-LD contents to be processed as plain JSON,
33173317
without using any of the JSON-LD algorithms.
@@ -3322,15 +3322,15 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
33223322
On the other hand, "plain JSON" implementations may not be able to interpret these embedded contexts,
33233323
and hence will still interpret those terms with their original meaning.
33243324
To prevent this divergence of interpretation,
3325-
JSON-LD 1.1 allows term definitions to be <em>sealed</em>.
3325+
JSON-LD 1.1 allows term definitions to be <em>protected</em>.
33263326
</p>
3327-
<p>A <dfn>sealed term definition</dfn> is a term definition with a member <code>@sealed</code> set to <code>true</code>.
3327+
<p>A <dfn>protected term definition</dfn> is a term definition with a member <code>@protected</code> set to <code>true</code>.
33283328
It prevents further contexts to override this term definition.
33293329
</p>
33303330

33313331

33323332
<aside class="example ds-selector-tabs changed"
3333-
title="A sealed term definition can not be overridden">
3333+
title="A protected term definition can not be overridden">
33343334
<div class="selectors">
33353335
<button class="selected" data-selects="original">Original</button>
33363336
<button data-selects="expanded">Expanded</button>
@@ -3348,7 +3348,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
33483348
"knows": "http://schema.org/knows",
33493349
"name": {
33503350
"@id": "http://schema.org/name",
3351-
****"@sealed": true****
3351+
****"@protected": true****
33523352
}
33533353
},
33543354
{
@@ -3368,7 +3368,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
33683368
</pre>
33693369
<pre class="expanded nohighlight"
33703370
data-transform="updateExample"
3371-
data-result-for="A sealed term definition can not be overridden-original">
3371+
data-result-for="A protected term definition can not be overridden-original">
33723372
<!--
33733373
[{
33743374
"@type": ["http://schema.org/Person"],
@@ -3380,7 +3380,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
33803380
-->
33813381
</pre>
33823382
<table class="statements"
3383-
data-result-for="A sealed term definition can not be overridden-expanded"
3383+
data-result-for="A protected term definition can not be overridden-expanded"
33843384
data-to-rdf>
33853385
<thead><tr><th>Subject</th><th>Property</th><th>Value</th></tr></thead>
33863386
<tbody>
@@ -3392,7 +3392,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
33923392
</table>
33933393
<pre class="turtle"
33943394
data-content-type="text/turtle"
3395-
data-result-for="A sealed term definition can not be overridden-expanded"
3395+
data-result-for="A protected term definition can not be overridden-expanded"
33963396
data-transform="updateExample"
33973397
data-to-rdf>
33983398
<!--
@@ -3409,16 +3409,16 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
34093409
</pre>
34103410
</aside>
34113411

3412-
<p>When all or most term definitions of a context need to be sealed,
3413-
it is possible to add a member <code>@sealed</code> set to <code>true</code>
3412+
<p>When all or most term definitions of a context need to be protected,
3413+
it is possible to add a member <code>@protected</code> set to <code>true</code>
34143414
to the context itself.
3415-
It has the same effect as sealing each of its term definitions individually.
3416-
Exceptions can be made by adding a member <code>@sealed</code> set to <code>false</code>
3415+
It has the same effect as protecting each of its term definitions individually.
3416+
Exceptions can be made by adding a member <code>@protected</code> set to <code>false</code>
34173417
in some term definitions.
34183418
</p>
34193419

34203420
<aside class="example ds-selector-tabs changed"
3421-
title="A sealed @context with an exception">
3421+
title="A protected @context with an exception">
34223422
<div class="selectors">
34233423
<button class="selected" data-selects="original">Original</button>
34243424
<button data-selects="expanded">Expanded</button>
@@ -3432,12 +3432,12 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
34323432
"@context": [
34333433
{
34343434
****"@version": 1.1****,
3435-
****"@sealed": true****,
3435+
****"@protected": true****,
34363436
"name": "http://schema.org/name",
34373437
"member": "http://schema.org/member",
34383438
"Person": {
34393439
"@id": "http://schema.org/Person",
3440-
****"@sealed": false****
3440+
****"@protected": false****
34413441
}
34423442
}
34433443
],
@@ -3455,7 +3455,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
34553455
</pre>
34563456
<pre class="expanded nohighlight"
34573457
data-transform="updateExample"
3458-
data-result-for="A sealed @context with an exception-original">
3458+
data-result-for="A protected @context with an exception-original">
34593459
<!--
34603460
[{
34613461
"http://schema.org/name": [{"@value": "Digital Bazaar"}],
@@ -3469,7 +3469,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
34693469
-->
34703470
</pre>
34713471
<table class="statements"
3472-
data-result-for="A sealed @context with an exception-expanded"
3472+
data-result-for="A protected @context with an exception-expanded"
34733473
data-to-rdf>
34743474
<thead><tr><th>Subject</th><th>Property</th><th>Value</th></tr></thead>
34753475
<tbody>
@@ -3481,7 +3481,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
34813481
</table>
34823482
<pre class="turtle"
34833483
data-content-type="text/turtle"
3484-
data-result-for="A sealed @context with an exception-expanded"
3484+
data-result-for="A protected @context with an exception-expanded"
34853485
data-transform="updateExample"
34863486
data-to-rdf>
34873487
<!--
@@ -3499,14 +3499,14 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
34993499
</pre>
35003500
</aside>
35013501

3502-
<p>While sealed term definitions can not be directly overridden,
3502+
<p>While protected term definitions can not be directly overridden,
35033503
it is worth noting that setting <code>@context</code> to <code>null</code>
35043504
will erase everything from the active context,
3505-
<em>including</em> sealed term definitions.
3505+
<em>including</em> protected term definitions.
35063506
</p>
35073507

35083508
<aside class="example ds-selector-tabs changed"
3509-
title="@context null erases sealed term definitions">
3509+
title="@context null erases protected term definitions">
35103510
<div class="selectors">
35113511
<button class="selected" data-selects="original">Original</button>
35123512
<button data-selects="expanded">Expanded</button>
@@ -3520,7 +3520,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
35203520
"@context": [
35213521
{
35223522
****"@version": 1.1****,
3523-
****"@sealed": true****,
3523+
****"@protected": true****,
35243524
"Organization": "http://schema.org/Organization",
35253525
"name": "http://schema.org/name",
35263526
"employee": {
@@ -3545,7 +3545,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
35453545
</pre>
35463546
<pre class="expanded nohighlight"
35473547
data-transform="updateExample"
3548-
data-result-for="@context null erases sealed term definitions-original">
3548+
data-result-for="@context null erases protected term definitions-original">
35493549
<!--
35503550
[{
35513551
"@type": ["http://schema.org/Organization"],
@@ -3559,7 +3559,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
35593559
-->
35603560
</pre>
35613561
<table class="statements"
3562-
data-result-for="@context null erases sealed term definitions-expanded"
3562+
data-result-for="@context null erases protected term definitions-expanded"
35633563
data-to-rdf>
35643564
<thead><tr><th>Subject</th><th>Property</th><th>Value</th></tr></thead>
35653565
<tbody>
@@ -3571,7 +3571,7 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
35713571
</table>
35723572
<pre class="turtle"
35733573
data-content-type="text/turtle"
3574-
data-result-for="@context null erases sealed term definitions-expanded"
3574+
data-result-for="@context null erases protected term definitions-expanded"
35753575
data-transform="updateExample"
35763576
data-to-rdf>
35773577
<!--
@@ -3589,14 +3589,14 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
35893589
</pre>
35903590
</aside>
35913591
<p class="note">By preventing terms from being overridden,
3592-
sealing also prevents any adaptation of a term
3592+
protection also prevents any adaptation of a term
35933593
(e.g., defining a more precise datatype, restricting the term's use to lists, etc.).
35943594
This kind of adaptation is frequent with some general purpose contexts,
3595-
for which sealing would therefore hinder their usability.
3595+
for which protection would therefore hinder their usability.
35963596
As a consequence, context publishers should use this feature with care.
35973597
</p>
35983598

3599-
<p class="note">Sealed term definitions are a new feature in JSON-LD 1.1, requiring
3599+
<p class="note">Protected term definitions are a new feature in JSON-LD 1.1, requiring
36003600
<a>processing mode</a> set to <code>json-ld-1.1</code>.</p>
36013601
</section>
36023602
</section>

0 commit comments

Comments
 (0)