From 4631b461a9f9880f8c97638b9a15e7e4da73279f Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Sun, 16 Apr 2023 17:23:06 -0400 Subject: [PATCH 1/3] Remove JSON section in lieu of `application/vc+ld+json`. --- index.html | 59 ++++++++---------------------------------------------- 1 file changed, 8 insertions(+), 51 deletions(-) diff --git a/index.html b/index.html index 770c10ca3..cc7e49415 100644 --- a/index.html +++ b/index.html @@ -3261,15 +3261,14 @@

Syntaxes

is the canonical structural representation of a verifiable credential or verifiable presentation. All serializations are representations of that data model in a specific format. This -section specifies how the data model is realized in JSON-LD and plain JSON. -Although syntactic mappings are provided for only these two syntaxes, +section specifies how the data model is realized in JSON-LD for the base +media type (`application/vc+ld+json`). +Although syntactic mappings are provided for JSON-LD, applications and services can use any other data representation syntax (such as -XML, YAML, or CBOR) that is capable of expressing the data model. As the -verification and validation requirements are defined in terms of -the data model, all serialization syntaxes have to be deterministically +XML, YAML, or CBOR) that is capable of being mapped back to the base media type. +As the verification and validation requirements are defined in terms +of the data model, all serialization syntaxes have to be deterministically translated to the data model for processing, validation, or comparison. -This specification makes no requirements for support of any specific -serialization format.

@@ -3298,47 +3297,6 @@

Syntaxes

or an array of values.

-
-

JSON

- -

-The data model, as described in Section , can be -encoded in JavaScript Object Notation (JSON) [[!RFC8259]] by mapping property -values to JSON types as follows: -

- - - -

-As the transformations listed herein have potentially incompatible -interpretations, additional profiling of the JSON format is required to provide -a deterministic transformation to the data model. -

- -
-

JSON-LD

@@ -3354,9 +3312,8 @@

JSON-LD

[[!JSON-LD]] is useful when extending the data model described in this -specification. Instances of the data model are encoded in [[!JSON-LD]] in the -same way they are encoded in JSON (Section ), with the -addition of the @context property. The +specification. Instances of the data model are encoded in [[!JSON-LD]] +and include the @context property. The JSON-LD context is described in detail in the [[!JSON-LD]] specification and its use is elaborated on in Section . From 654b694fd41580ba7724d1593f5c1906de3180e5 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Sat, 22 Apr 2023 12:26:11 -0400 Subject: [PATCH 2/3] Fix up section on base media type. Co-authored-by: Ted Thibodeau Jr Co-authored-by: Orie Steele --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index cc7e49415..73280489b 100644 --- a/index.html +++ b/index.html @@ -3261,11 +3261,11 @@

Syntaxes

is the canonical structural representation of a verifiable credential or verifiable presentation. All serializations are representations of that data model in a specific format. This -section specifies how the data model is realized in JSON-LD for the base -media type (`application/vc+ld+json`). -Although syntactic mappings are provided for JSON-LD, +section specifies how the data model is realized in JSON-LD for +`application/vc+ld+json`, the base media type for Verifiable Credentials. +Although syntactic mappings are only provided for JSON-LD, applications and services can use any other data representation syntax (such as -XML, YAML, or CBOR) that is capable of being mapped back to the base media type. +XML, YAML, or CBOR) that is capable of being mapped back to `application/vc+ld+json`. As the verification and validation requirements are defined in terms of the data model, all serialization syntaxes have to be deterministically translated to the data model for processing, validation, or comparison. From 3ef0175a4931bafc30dd73f893889e6f6ce25c8b Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Sat, 22 Apr 2023 12:30:04 -0400 Subject: [PATCH 3/3] Mention that JSON-LD compact form is used. --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 73280489b..f0207d43a 100644 --- a/index.html +++ b/index.html @@ -3312,8 +3312,8 @@

JSON-LD

[[!JSON-LD]] is useful when extending the data model described in this -specification. Instances of the data model are encoded in [[!JSON-LD]] -and include the @context property. The +specification. Instances of the data model are encoded in JSON-LD compact +form [[!JSON-LD]] and include the @context property. The JSON-LD context is described in detail in the [[!JSON-LD]] specification and its use is elaborated on in Section .