Skip to content

Commit

Permalink
json-ld representation: Move normative language about @context URIs.
Browse files Browse the repository at this point in the history
Normative requirements about dereferencing and and hashing contents
of @context URIs are requirements on a producer rather than a
consumer, so these statements have been moved accordingly. (#384)

Also removes normative language around conforming to JSON-LD
production rules as this is not a requirement on the consumer, but
advisory.
  • Loading branch information
rhiaro committed Oct 13, 2020
1 parent a2cc42f commit 6c6a29c
Showing 1 changed file with 20 additions and 25 deletions.
45 changes: 20 additions & 25 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -2579,22 +2579,25 @@ <h3>
<p>
All members of the <code>@context</code> property SHOULD exist in the DID
specification registries [[DID-SPEC-REGISTRIES]] in order to achieve
interoperability across different representations.
interoperability across different representations. If a member does not exist
in the DID specification registries, then the <a>DID document</a> might not be
interoperable across representations.
</p>

<p>
If a member does not exist in the DID specification registries, then the
<a>DID document</a> might not be interoperable across representations.
It is RECOMMENDED that dereferencing each <a>URI</a> value of the
<code>@context</code> property results in a document containing
machine-readable information about the context. These URIs SHOULD be
associated with a cryptographic hash of the content of the JSON-LD Context as
part of registration in the DID Specification Registries [[DID-SPEC-REGISTRIES]].
</p>

<p>
</dd>
</dl>
<p>
Producers SHOULD NOT produce <a>DID documents</a> that contain properties not
defined via the <code>@context</code>. Properties that are not defined via the
<code>@context</code> MAY be dropped by Consumers.
</p>

</dd>
</dl>
</p>

</section>

Expand All @@ -2613,20 +2616,12 @@ <h3>
<dl>
<dt>@context</dt>
<dd>
The value of the <code>@context</code> property MUST conform
to the <a href="#production-0">JSON-LD Production Rules</a>.

If more than one <a>URI</a> is
provided, the <a>URIs</a> MUST be interpreted as an ordered set. It is
RECOMMENDED that dereferencing each <a>URI</a> results in a document containing
machine-readable information about the context. To enable interoperability
with other representations, URLs registered in the
DID Specification Registries [[DID-SPEC-REGISTRIES]] referring to
JSON-LD Contexts SHOULD be associated with a cryptographic hash of
the content of the JSON-LD Context. This ensures that the interpretation of the
information by JSON-LD consumers will be the same as interpretations
over other representations by other consumers that rely on the
DID Specification Registries [[DID-SPEC-REGISTRIES]].
<p>
The value of the <code>@context</code> property conform to the
<a href="#production-0">JSON-LD Production Rules</a>. If more than one
<a>URI</a> is provided, the <a>URIs</a> MUST be interpreted as an
<a data-cite="INFRA#ordered-set">ordered set</a>.
</p>
</dd>
</dl>

Expand All @@ -2641,8 +2636,8 @@ <h3>
</p>

<p>
Consumers SHOULD drop all properties from a DID Documents that
are not defined via the <code>@context</code>.
Consumers SHOULD drop all properties from a DID Documents that are not defined
via the <code>@context</code>.
</p>

</section>
Expand Down

0 comments on commit 6c6a29c

Please sign in to comment.