You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: EXPLAINER.md
+6-5Lines changed: 6 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# VC JSON Schema Explained
2
2
3
-
[Verifiable Credentials](https://w3c.github.io/vc-data-model/) provide a JSON-LD data model that enables the issuance, sharing, and verification of digital credentials in a secure and interoperable manner. These credentials provide a way for individuals, organizations, and other entities to digitally represent and share their qualifications, attributes, or other relevant information. Verifiable Credentials are designed to enhance trust, privacy, and control in digital interactions by allowing the owner of the credentials to control how their information is shared and verified.
3
+
[Verifiable Credentials](https://w3c.github.io/vc-data-model/) provide a JSON-LD data model that enables the issuance, sharing, and verification of digital credentials in a secure and interoperable manner. These credentials provide a way for individuals, organizations, and other entities to digitally represent and share their qualifications, attributes, and/or other relevant information. Verifiable Credentials are designed to enhance trust, privacy, and control in digital interactions by allowing the owner of the credentials to control how their information is shared and verified.
4
4
5
5
## Authors
6
6
@@ -20,20 +20,21 @@ Leveraging the section on [Data Schemas](https://w3c.github.io/vc-data-model/#da
20
20
As stated in the data model:
21
21
22
22
> Data schemas are useful when enforcing a specific structure on a given collection of data.
23
+
>
23
24
> Data verification schemas, which are used to verify that the structure and contents of a credential or verifiable credential conform to a published schema.
24
25
25
26
26
27
## How It Works
27
28
28
-
Before constructing or issuing a verifiable credential there must first be a JSON Schema. The JSON Schema can exist anywhere as long as it is URI-addressable. The JSON Schema can be conformant to any specification versions listed in the latest draft of this specification. We provide two `type` values for using JSON Schema within the `credentialSchema` property of a verifiable credential:
29
+
Before constructing or issuing a verifiable credential, there must first be a JSON Schema. The JSON Schema can exist anywhere as long as it is URI-addressable. The JSON Schema can be conformant to any specification version listed in the latest draft of this specification. We provide two `type` values for using JSON Schema within the `credentialSchema` property of a verifiable credential:
29
30
30
31
1.`JsonSchema2023`
31
32
32
-
For plain usage of a JSON Schema we make available the type `JsonSchema2023`.
33
+
For plain use of a JSON Schema, we make available the type `JsonSchema2023`.
33
34
34
35
2.`CredentialSchema2023`
35
36
36
-
There is an option to wrap the JSON Schema in a verifiable credential, should the author of the schema want to add additional features such as status, integrity protection, or retaining authorship information. When using a JSON Schema packaged as a verifiable credential we make available the type `CredentialSchema2023`.
37
+
Should the author of a JSON schema want to add additional features such as status, integrity protection, or retaining authorship information, there is an option to wrap the schema in a verifiable credential. For use of a JSON Schema packaged as a verifiable credential, we make available the type `CredentialSchema2023`.
37
38
38
39
### Example using JsonSchema2023
39
40
@@ -147,4 +148,4 @@ There is an option to wrap the JSON Schema in a verifiable credential, should th
147
148
148
149
## Conclusions
149
150
150
-
This document is a high-level summary of VC JSON Schemas, an option for utilizing the `credentialSchema` property in the VC Data Model. There may be other `type` definitions that make use of different schema mechanisms besides JSON Schema as the VC Data Model is by design open and extensible.
151
+
This document is a high-level summary of VC JSON Schemas as one option for use of the `credentialSchema` property in the VC Data Model. There may be other `type` definitions that make use of schema mechanisms other than JSON Schema, as the VC Data Model is by design open and extensible.
Copy file name to clipboardExpand all lines: README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ This specification provides a mechanism for the use of [JSON Schemas](https://js
5
5
https://w3c.github.io/vc-json-schema/
6
6
7
7
We encourage contributions meeting the [Contribution Guidelines](CONTRIBUTING.md). While we prefer the creation of issues
8
-
and Pull Requests in the GitHub repository, discussions often occur on the [public-credentials](http://lists.w3.org/Archives/Public/public-credentials/) mailing list as well.
8
+
and Pull Requests in the GitHub repository, discussions may also occur on the [public-credentials](http://lists.w3.org/Archives/Public/public-credentials/) mailing list.
0 commit comments