diff --git a/index.html b/index.html index 03476e0e8..ed04194d0 100644 --- a/index.html +++ b/index.html @@ -4221,18 +4221,19 @@

JSON-LD

for more details.

-
-

Syntactic Sugar

+
+

Notable JSON-LD Features

-In general, the data model and syntaxes described in this document are -designed such that developers can copy and paste examples to incorporate -[=verifiable credentials=] into their software systems. The design goal of -this approach is to provide a low barrier to entry while still ensuring global -interoperability between a heterogeneous set of software systems. This section -describes some of these approaches, which will likely go unnoticed by most -developers, but whose details will be of interest to implementers. The most -noteworthy syntactic sugars provided by [[!JSON-LD11]] are: +In general, the data model and syntax described in this document enables +developers to largely treat [=verifiable credentials=] as JSON documents, +allowing them to copy and paste examples, with minor modification, into their +software systems. The design goal of this approach is to provide a low barrier +to entry while still ensuring global interoperability between a heterogeneous +set of software systems. This section describes some of the JSON-LD features +that are used to make this possible, which will likely go unnoticed by most +developers, but whose details might be of interest to implementers. The most +noteworthy features in [[[JSON-LD11]]] used by this specification include:

-
+

Restrictions on JSON-LD

-This specification restricts the usage of JSON-LD representations of -the data model. JSON-LD compacted document form MUST be utilized for all representations of the data model using the -`application/vc` base media type. +`application/vc` or `application/vp` media type.

@@ -4316,7 +4317,7 @@

Restrictions on JSON-LD

`https://www.w3.org/2018/credentials#VerifiableCredential` or `https://vocab.example/myvocab#SomeNewType`) instead of the short forms of any such values (for example, `VerifiableCredential` or `SomeNewType`) that are -explicitly defined as JSON-LD `@context` mappings (for example, +explicitly defined in JSON-LD `@context` mappings (for example, in `https://www.w3.org/ns/credentials/v2`) @@ -4336,7 +4337,7 @@

Restrictions on JSON-LD

-
+

Lists and Arrays

Lists, arrays, and even lists of lists, are possible when using [[JSON-LD11]] 1.1. @@ -4421,7 +4422,7 @@

Media Types

regardless of the media type used to communicate it.

-
+

Media Type Precision