Skip to content

Commit 5b8a09d

Browse files
authored
fix language, punctuation, etc., in EXPLAINER.md & README.md (#165)
1 parent ea3515d commit 5b8a09d

File tree

2 files changed

+8
-7
lines changed

2 files changed

+8
-7
lines changed

EXPLAINER.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# VC JSON Schema Explained
22

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.
44

55
## Authors
66

@@ -20,20 +20,21 @@ Leveraging the section on [Data Schemas](https://w3c.github.io/vc-data-model/#da
2020
As stated in the data model:
2121

2222
> Data schemas are useful when enforcing a specific structure on a given collection of data.
23+
>
2324
> Data verification schemas, which are used to verify that the structure and contents of a credential or verifiable credential conform to a published schema.
2425
2526

2627
## How It Works
2728

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:
2930

3031
1. `JsonSchema2023`
3132

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`.
3334

3435
2. `CredentialSchema2023`
3536

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`.
3738

3839
### Example using JsonSchema2023
3940

@@ -147,4 +148,4 @@ There is an option to wrap the JSON Schema in a verifiable credential, should th
147148

148149
## Conclusions
149150

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.

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ This specification provides a mechanism for the use of [JSON Schemas](https://js
55
https://w3c.github.io/vc-json-schema/
66

77
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.
99

1010
### Building
1111

@@ -20,4 +20,4 @@ respec --localhost index.html out.html --verbose -e
2020
Next open up `out.html` in a web browser and review the document.
2121

2222
### Other useful links
23-
* [Public group email archive](https://lists.w3.org/Archives/Public/public-credentials/)
23+
* [Public group email archive](https://lists.w3.org/Archives/Public/public-credentials/)

0 commit comments

Comments
 (0)