diff --git a/index.html b/index.html index 201cde126..7b6eeeac0 100644 --- a/index.html +++ b/index.html @@ -3558,7 +3558,7 @@

Reserved Extension Points

`confidenceMethod` -A property used for specifying one or more methods that a verifier +A property used for specifying one or more methods that a verifier might use to increase their confidence that the value of an attribute in or of a verifiable credential or verifiable presentation is accurate, including but not limited to attributes such as `initialRecipient` (a/k/a `issuee`), `presenter`, @@ -3952,6 +3952,78 @@

Media Type Precision

+
+

JSON Processing

+ +

+While the media types describing conforming documents defined in this +specification always express JSON-LD, JSON-LD processing is not required to be +performed, since JSON-LD is JSON. Some scenarios where processing a +verifiable credential or a verifiable presentation as JSON is +desirable include, but are not limited to: +

+ + + +

+That is, JSON processing is allowed as long as the document being consumed or +produced is a conforming document. If JSON processing is desired, an +implementer is advised to follow the following rule: +

+ + + +

+Using static context files with a JSON Schema is one acceptable approach to +implementing the rule above. This can ensure proper term identification, +typing, and order, when a JSON document is processed as JSON-LD. +

+ +

+The rule above guarantees semantic interoperability between JSON and JSON-LD for +literal JSON keys mapped to URIs by the `@context` mechanism. While JSON-LD +processors will use the specific mechanism provided and can verify that all +terms are correctly specified, JSON-based processors implicitly accept the same +semantics without performing any JSON-LD transformations, but instead by +applying the above rules. In other words, the context in which the data exchange +happens is explicitly stated for both JSON and JSON-LD by using the same +mechanism. With respect to JSON-based processors, this is achieved in a +lightweight manner, without having to use JSON-LD processing libraries. +

+ +