diff --git a/index.html b/index.html index f43472f..647fc7c 100644 --- a/index.html +++ b/index.html @@ -157,7 +157,7 @@
- Implementers may find use in packaging a JSON Schema as a verifiable credential when they wish to + Implementers MAY package a [[JSON-SCHEMA]] as a verifiable credential when they wish to leverage features of the [[VC-DATA-MODEL-2.0]], answering questions such as:
issuer
property)- In the upcoming sections we list some keywords that possess unique significance and - should not be used in conflicting ways. + In the upcoming sections we list some keywords that possess unique significance in + [[JSON-SCHEMA]] documents and SHOULD NOT be used in conflicting ways, such as redefining + these keywords, or using them in a manner other than as noted by [[JSON-SCHEMA]] specifications.
Furthermore, we identify specific keywords, that are not explicitly defined by JSON Schema, @@ -534,9 +535,9 @@
- Across JSON Schema specifications, the $id
keyword identifies a schema resource
- with its canonical [[RFC6596]] URI. The $id
MUST be present and its value
- MUST represent a valid URI-reference [[RFC3986]].
+ Across JSON Schema specifications, the $id
keyword identifies a schema resource
+ with its canonical URI. The $id
MUST be present, and its value MUST represent
+ a valid URI-reference as specified by the associated [[JSON-SCHEMA]] version.
It is RECOMMENDED that the value of the $id
property match the id
@@ -617,8 +618,8 @@
Credential Schemas MAY be packaged as verifiable credentials as defined by usage of the JsonSchemaCredential type. - The credential containing a credential schema may include a proof, either - embedded according to + The credential containing a credential schema MAY be secured by using either an + embedded or external proof as defined in Securing Verifiable Credentials.
@@ -760,7 +761,7 @@
- Assuming that the implementer does not support [[JSON-SCHEMA-2019-09]], an example of an Indeterminate + Assuming that the implementer does not support [[?JSON-SCHEMA-2019-09]], an example of an Indeterminate evaluation is provided below.
@@ -1274,24 +1275,27 @@
JsonSchema
- This specification acknowledges the use of the application/schema+json
- and application/json
Media Types specifically for identifying a [[JSON-SCHEMA]]
- with usage of the JsonSchema type, as registered in
- JSON Schema specifications.
+ The media type application/schema+json
, as defined in
+ [[JSON-SCHEMA]], SHOULD be used when transmitting a [[JSON-SCHEMA]] expressed
+ as JSON over HTTP. Clients receiving [[JSON-SCHEMA]] files over HTTP MAY accept content
+ using either the application/schema+json
media type or the
+ application/json
media type as defined in [[JSON]].
When using the JsonSchema type with a [[YAML]]
- representation of a [[JSON-SCHEMA]], defined by [[[OPENAPIS-3.1.0]]], the types application/openapi+yaml
- or application/yaml
may be used.
+ representation of a [[JSON-SCHEMA]], defined by [[[OPENAPIS-3.1.0]]], the types
+ application/openapi+yaml
or application/yaml
MAY be used.
JsonSchemaCredential
- This specification acknowledges the use of the application/vc+ld+json
,
- application/vc+ld+json+jwt
, and application/vc+ld+json+sd-jwt
Media Types
- specifically for identifying a [[JSON-SCHEMA]] with usage of the
- JsonSchemaCredential type, as registered in the [[VC-DATA-MODEL-2.0]], [[VC-JOSE-COSE]], and [[SD-JWT]] specifications respectively.
+ The media types application/vc+ld+json
, application/vc+ld+json+jwt
, or
+ application/vc+ld+json+sd-jwt
as defined in [[VC-DATA-MODEL-2.0]],
+ [[VC-JOSE-COSE]], or [[SD-JWT]] specifications, respectively, SHOULD be used when
+ transmitting a [[JSON-SCHEMA]] represented as a verifiable credential with usage of
+ the JsonSchemaCredential type. Clients receiving credential schemas
+ files over HTTP MAY accept content using any of these types.