From 031f07d11367e5ab42a1e98287788278f567dbe4 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Wed, 19 Jul 2023 14:15:01 +0200 Subject: [PATCH 1/9] Refreshed vocabulary, using back links to the main doc. --- index.html | 20 ++-- vocab/credentials/v2/template.html | 23 ++++- vocab/credentials/v2/vocabulary.yml | 140 +++++++++++++--------------- 3 files changed, 95 insertions(+), 88 deletions(-) diff --git a/index.html b/index.html index ca705cdbf..16a6f4e7a 100644 --- a/index.html +++ b/index.html @@ -1493,7 +1493,7 @@

Credential Subject

-
credentialSubject
+
credentialSubject
The value of the credentialSubject property is defined as a set of objects that MUST contain one or more claims that are each related to a @@ -1569,7 +1569,7 @@

Issuer

-
issuer
+
issuer
The value of the issuer property MUST be either a URL or an object containing an id property. It is @@ -1650,7 +1650,7 @@

Validity Period

-
validFrom
+
validFrom
If present, the value of the validFrom property MUST be an [XMLSCHEMA11-2] @@ -1660,7 +1660,7 @@

Validity Period

at which the information associated with the credentialSubject property becomes valid.
-
validUntil
+
validUntil
If present, the value of the validUntil property MUST be an [XMLSCHEMA11-2] @@ -1896,7 +1896,7 @@

Status

-
credentialStatus
+
credentialStatus
If present, the value of the credentialStatus property MUST include the following: @@ -1996,14 +1996,14 @@

Presentations

VerifiablePresentation, but additional types MAY be included. The related normative guidance in Section MUST be followed.
-
verifiableCredential
+
verifiableCredential
The verifiableCredential property MAY be present. The value MUST be an array of one or more verifiable credentials, or of data derived from verifiable credentials in a cryptographically verifiable format.
-
holder
+
holder
The verifiable presentation MAY include a holder property. If present, the value MUST be either a URL or an object @@ -2903,7 +2903,7 @@

Refreshing

-
refreshService
+
refreshService
The value of the refreshService property MUST be one or more refresh services that provides enough information to the recipient's software @@ -2991,7 +2991,7 @@

Terms of Use

-
termsOfUse
+
termsOfUse
The value of the termsOfUse property MUST specify one or more terms of use policies under which the creator issued the credential @@ -3154,7 +3154,7 @@

Evidence

-
evidence
+
evidence
The value of the evidence property MUST be one or more evidence schemes providing enough information for a verifier to determine diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html index 3e529b349..332e3943e 100644 --- a/vocab/credentials/v2/template.html +++ b/vocab/credentials/v2/template.html @@ -133,7 +133,6 @@ archives).

-

Namespaces

This specification makes use of the following namespaces:

@@ -157,6 +156,28 @@

Definitions for individuals

+
+

Reserved term definitions

+ +

All terms in this section are + reserved. + Implementers may use these properties, but should expect them and/or their meanings to change during the process to + normatively specify them. +

+ +
+

Reserved classes

+
+ +
+

Reserved properties

+
+ +
+

Reserved individuals

+
+
+

Deprecated term definitions

diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index ddc7a584a..ec6de145d 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -2,9 +2,9 @@ vocab: - id: cred value: https://w3.org/2018/credentials# -prefix: - - id: odrl - value: http://www.w3.org/ns/odrl/2/ +# prefix: +# - id: odrl +# value: http://www.w3.org/ns/odrl/2/ ontology: - property: dc:title @@ -17,160 +17,146 @@ ontology: value: https://www.w3.org/TR/vc-data-model-2.0/ class: - - id: JsonSchemaValidator2018 - label: Json schema validator 2018 - upper_value: cred:CredentialSchema - deprecated: true - comment: A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language. - - - id: JsonSchema2023 - label: JSON schema validator 2023 - upper_value: cred:CredentialSchema - comment: A type of validator that can be used to syntactically validate JSON documents using the JSON Schema language. - - - id: VerifiableCredentialSchema2023 - label: Credential schema validator 2023 - comment: A type of validator that can be used to syntactically validate JSON documents packaged as Verifiable Credentials using the JSON Schema language. - - - id: ManualRefreshService2018 - label: Manual refresh service 2018 - upper_value: cred:RefreshService - deprecated: true - comment: A type of Refresh Service that must be interacted with in a manual fashion. - - - id: RefreshService - label: Refresh service - comment: A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential. + - id: CredentialEvidence + label: Credential Evidence + comment: A Credential Evidence provides evidence schemes that are used by the evidence property. This class serves as a supertype for specific evidence types. - id: CredentialSchema label: Credential schema - comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. + comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. This class serves as a supertype for specific schemas (e.g., JsonSchema2023). - id: CredentialStatus label: Credential status - comment: A Credential Status provides enough information to determine the current status of the credential (for example, suspended or revoked). It MUST include the `id` property, which MUST be a URL, and the `type` property, which expresses the credential status type (also referred to as the credential status scheme) + comment: A Credential Status provides enough information to determine the current status of the credential (for example, suspended or revoked). This class serves as a supertype for specific status types. + + - id: JsonSchema2023 + label: JSON schema validator 2023 + defined_by: https://www.w3.org/TR/vc-json-schema/#jsonschema2023 + upper_value: cred:CredentialSchema + comment: A type of validator for the validation of Verifiable Credentials, based on JSON Schema. - - id: StatusList2021Entry - label: Status List 2021 Entry - comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. + - id: RefreshService + label: Refresh service + comment: A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential. This class serves as a supertype for specific refresh service types. - - id: StatusList2021Credential - label: Status List 2021 Credential - comment: A Status List 2021 Credential provides issuers with a mechanism to publish a verifiable credential which encapsulates a status list. + - id: TermsOfUse + label: Terms of use + comment: Policy under which the creator issued the credential or presentation. This class serves as a supertype for specific types for terms of use. - - id: CredentialEvidence - label: Credential evidence - comment: A Credential Evidence scheme provides enough information to a verifier to determine whether the evidence gathered meets their requirements for issuing a credential. The precise content of each evidence scheme is determined by the specific evidence type definition. + # - id: StatusList2021Entry + # label: Status List 2021 Entry + # comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. - id: VerifiableCredential + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#credentials label: Verifiable credential - comment: | - A Credential is a set of one or more claims made by an issuer. A Verifiable Credential is a tamper-evident credential that has authorship that can be cryptographically verified. Verifiable Credentials can be used to build Verifiable Presentations, which can also be cryptographically verified. - id: VerifiableCredentialGraph label: Verifiable credential graph - comment: Instances of this class are RDF Graphs, where each of these graphs must include exactly one Verifiable Credential + comment: Instances of this class are RDF Graphs [[RDF12-CONCEPTS]], where each of these graphs must include exactly one Verifiable Credential. - id: VerifiablePresentation + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#presentations label: Verifiable presentation - comment: | - A Presentation is data derived from one or more Credentials, issued by one or more `issuers`, that is shared with a specific `verifier`. A Verifiable Presentation is a tamper-evident Presentation encoded in such a way that authorship of the data can be trusted after a process of cryptographic verification. Certain types of verifiable presentations might contain data that is synthesized from, but do not contain, the original verifiable credentials (for example, zero-knowledge proofs). property: - id: credentialSchema label: Credential schema + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-credentialSchema domain: cred:VerifiableCredential range: cred:CredentialSchema - comment: The value of the `credentialSchema` property MUST be one or more Credential schema instances. - id: credentialStatus label: Credential status + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-credentialStatus domain: cred:VerifiableCredential range: cred:CredentialStatus - comment: The value of the `credentialStatus` property MUST be an instance of a Credential status. - id: credentialSubject label: Credential subject + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-credentialSubject domain: cred:VerifiableCredential range: IRI comment: An entity about which claims are made. - id: evidence label: Evidence + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-evidence domain: cred:VerifiableCredential + status: reserved range: cred:CredentialEvidence - comment: The value of the `evidence` property MUST be one or more Credential evidence instances. - id: expirationDate label: Expiration date domain: cred:VerifiableCredential + defined_by: https://www.w3.org/TR/vc-data-model/#expiration range: xsd:dateTime deprecated: true - comment: The value of the `expirationDate` property was used to express the date and time the credential ceases to be valid. It has been deprecated in favor of `validUntil` + comment: The value of the property was used to express the date and time the credential ceases to be valid. It has been deprecated in favor of validUntil - id: holder label: Holder domain: cred:VerifiablePresentation + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-holder range : IRI - comment: | - The value of the `holder` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the holder that can be used to verify the information expressed in the credential. - + - id: issuanceDate label: Issuance date domain: cred:VerifiableCredential + defined_by: https://www.w3.org/TR/vc-data-model/#issuance-date range: xsd:dateTime deprecated: true - comment: | - The value of the `issuanceDate` property was used to represents the earliest date when the information associated with the `credentialSubject` property became valid. This property has been deprecated in favour of `validFrom`. - - - id: issued - label: issue date - domain: cred:VerifiableCredential - range: xsd:dateTime - comment: | - The value of the `issued` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential was issued. Note that this date represents the earliest date when the information associated with the credentialSubject property became valid. This property has been deprecated in favor of validFrom. - id: issuer - label: issuer + label: Issuer + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-issuer domain: cred:VerifiableCredential range: IRI - comment: | - The value of the `issuer` property MUST be a URI. It is RECOMMENDED that dereferencing the URI results in a document containing machine-readable information about the issuer that can be used to verify the information expressed in the credential. - + comment: The value of the property must be a URL uniquely identifying the issuer. + - id: refreshService - label: refresh service + label: Refresh service + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-refreshService domain: cred:VerifiableCredential + status: reserved range: cred:RefreshService - comment: The value of the `refreshService` property MUST be one or more Refresh Service instances such that the holder can refresh the credential. + + - id: renderMethod + label: Render method + domain: cred:VerifiableCredential + status: reserved + range: cred:RefreshService + comment: A property used for specifying how to render a credential into a visual, auditory, or haptic format. - id: serviceEndpoint - label: service endpoint + label: Service endpoint domain: cred:RefreshService range: IRI - comment: The value of the `serviceEndpoint` property MUST be a URL to the service endpoint associated with the subject. + comment: The value of the property must be a URL to the service endpoint associated with the subject. - id: termsOfUse - label: terms of use - domain: cred:VerifiableCredential,cred:VerifiablePresentation - range: odrl:Policy - comment: | - If specified, the value of the optional `termsOfUse` property MUST specify one or more terms of use policies under which the issuer issued the credential or presentation. Each `termsOfUse` policy MUST specify its type (for example, `IssuerPolicy`) and MAY specify its instance `id`. The precise content of each term of use is determined by the specific `TermsOfUse` type definition. If the recipient (a holder or verifier) violates the specified terms of use, the responsibility is their own, and such violation may incur legal liability. + label: Terms of use + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-termsOfUse + domain: [cred:VerifiableCredential, cred:VerifiablePresentation] + status: reserved + range: TermsOfUse - id: validFrom label: Valid from domain: cred:VerifiableCredential + defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-validFrom range: xsd:dateTime - comment: | - The value of the `validFrom` property MUST be a string value of an ISO8601 combined date and time string representing the date and time the credential was issued. Note that this date represents the earliest date when the information associated with the Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph). + comment: The value of the property must identify a Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph). From 9c7c0b03d5891269fdeaaf5976928f65ad371e0b Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Thu, 20 Jul 2023 09:08:00 +0200 Subject: [PATCH 2/9] Update the domain of validFrom/validUntil. --- vocab/credentials/v2/vocabulary.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index ec6de145d..1b360a982 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -144,14 +144,14 @@ property: - id: validFrom label: Valid from - domain: cred:VerifiableCredential + domain: [cred:VerifiableCredential, cred:VerifiablePresentation] defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-validFrom range: xsd:dateTime - id: validUntil defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-validUntil label: Valid until - domain: cred:VerifiableCredential + domain: [cred:VerifiableCredential, cred:VerifiablePresentation] range: xsd:dateTime - id: verifiableCredential From e81155d931e427a4d6b4b8ba13ea0ffe3cf1da32 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Fri, 21 Jul 2023 11:39:19 +0200 Subject: [PATCH 3/9] Update entries in vocabulary to match spec. --- vocab/credentials/v2/vocabulary.yml | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index 1b360a982..29d7ae1ff 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -43,9 +43,10 @@ class: label: Terms of use comment: Policy under which the creator issued the credential or presentation. This class serves as a supertype for specific types for terms of use. - # - id: StatusList2021Entry - # label: Status List 2021 Entry - # comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. + - id: StatusList2021Entry + label: Status List 2021 Entry + deprecated: true + comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. Placeholder for now; this item may change to something else. - id: VerifiableCredential defined_by: https://www.w3.org/TR/vc-data-model-2.0/#credentials @@ -88,8 +89,7 @@ property: - id: expirationDate label: Expiration date - domain: cred:VerifiableCredential - defined_by: https://www.w3.org/TR/vc-data-model/#expiration + defined_by: https://www.w3.org/TR/2022/REC-vc-data-model-20220303/#expiration range: xsd:dateTime deprecated: true comment: The value of the property was used to express the date and time the credential ceases to be valid. It has been deprecated in favor of validUntil @@ -102,8 +102,7 @@ property: - id: issuanceDate label: Issuance date - domain: cred:VerifiableCredential - defined_by: https://www.w3.org/TR/vc-data-model/#issuance-date + defined_by: https://www.w3.org/TR/2022/REC-vc-data-model-20220303/#issuance-date range: xsd:dateTime deprecated: true comment: The value of the property was used to represent the earliest date when the information associated with the credentialSubject property became valid. This property has been deprecated in favor of validFrom. @@ -125,15 +124,15 @@ property: - id: renderMethod label: Render method domain: cred:VerifiableCredential + defined_by: https://w3c-ccg.github.io/vc-render-method/#the-rendermethod-property status: reserved range: cred:RefreshService - comment: A property used for specifying how to render a credential into a visual, auditory, or haptic format. - id: serviceEndpoint label: Service endpoint domain: cred:RefreshService range: IRI - comment: The value of the property must be a URL to the service endpoint associated with the subject. + comment: The value of the property must be a URL to the service endpoint associated with the subject. There is no URL yet in a VCWG document to define this term. - id: termsOfUse label: Terms of use From 1134b55006688b1e2d973b8cc963c3825509abc5 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Mon, 24 Jul 2023 12:13:34 +0200 Subject: [PATCH 4/9] Fix editorial issues with v2 vocabulary. Co-authored-by: Ted Thibodeau Jr --- vocab/credentials/v2/vocabulary.yml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index 29d7ae1ff..4db5f72d3 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -19,11 +19,11 @@ ontology: class: - id: CredentialEvidence label: Credential Evidence - comment: A Credential Evidence provides evidence schemes that are used by the evidence property. This class serves as a supertype for specific evidence types. + comment: A Credential Evidence provides an evidence scheme that is used by the evidence property. This class serves as a supertype for specific evidence types. - id: CredentialSchema label: Credential schema - comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. This class serves as a supertype for specific schemas (e.g., JsonSchema2023). + comment: A Credential Schema provides a verifier with enough information to determine if the provided data conforms to the provided schema. This class serves as a supertype for specific schemas (e.g., JsonSchema2023). - id: CredentialStatus label: Credential status @@ -37,11 +37,11 @@ class: - id: RefreshService label: Refresh service - comment: A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential. This class serves as a supertype for specific refresh service types. + comment: A Refresh Service is a mechanism that can be used by a software agent to retrieve an updated copy of a Verifiable Credential. This class serves as a supertype for specific refresh service types. - id: TermsOfUse label: Terms of use - comment: Policy under which the creator issued the credential or presentation. This class serves as a supertype for specific types for terms of use. + comment: Terms of use reflect the policy/ies under which the issuer issued the credential or presentation. This class serves as a supertype for specific types of terms of use. - id: StatusList2021Entry label: Status List 2021 Entry @@ -92,7 +92,7 @@ property: defined_by: https://www.w3.org/TR/2022/REC-vc-data-model-20220303/#expiration range: xsd:dateTime deprecated: true - comment: The value of the property was used to express the date and time the credential ceases to be valid. It has been deprecated in favor of validUntil + comment: The value of this property was used in the past to express the date and time the credential ceased to be valid. It has been deprecated in favor of validUntil - id: holder label: Holder @@ -105,14 +105,14 @@ property: defined_by: https://www.w3.org/TR/2022/REC-vc-data-model-20220303/#issuance-date range: xsd:dateTime deprecated: true - comment: The value of the property was used to represent the earliest date when the information associated with the credentialSubject property became valid. This property has been deprecated in favor of validFrom. + comment: The value of this property was used in the past to represent the earliest date when the information associated with the credentialSubject property became valid. This property has been deprecated in favor of validFrom. - id: issuer label: Issuer defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-issuer domain: cred:VerifiableCredential range: IRI - comment: The value of the property must be a URL uniquely identifying the issuer. + comment: The value of this property must be a URL uniquely identifying the issuer. - id: refreshService label: Refresh service @@ -132,7 +132,7 @@ property: label: Service endpoint domain: cred:RefreshService range: IRI - comment: The value of the property must be a URL to the service endpoint associated with the subject. There is no URL yet in a VCWG document to define this term. + comment: The value of this property must be a URL to the service endpoint associated with the subject. There is no URL yet in a VCWG document to define this term. - id: termsOfUse label: Terms of use @@ -158,4 +158,4 @@ property: label: Verifiable credential domain: cred:VerifiablePresentation range: cred:VerifiableCredentialGraph - comment: The value of the property must identify a Verifiable credential graph (informally, it indirectly identifies a Verifiable credential contained in a separate graph). + comment: The value of this property identifies a Verifiable credential graph. (Informally, it indirectly identifies a Verifiable credential contained in a separate graph.) From c885cfe2e069ee7715de1406938292c7d2a7b2f3 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Tue, 25 Jul 2023 09:05:16 +0200 Subject: [PATCH 5/9] Fix missing prefix in TermsOfUse. Co-authored-by: Pierre-Antoine Champin --- vocab/credentials/v2/vocabulary.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index 4db5f72d3..f425a22fc 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -139,7 +139,7 @@ property: defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-termsOfUse domain: [cred:VerifiableCredential, cred:VerifiablePresentation] status: reserved - range: TermsOfUse + range: cred:TermsOfUse - id: validFrom label: Valid from From 4f48b5d8d2f82921197a2f91e4be9916674d30b3 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Tue, 25 Jul 2023 14:19:51 +0200 Subject: [PATCH 6/9] Add section on specification of terms. --- vocab/credentials/v2/template.html | 15 ++++++++++++--- vocab/credentials/v2/vocabulary.yml | 1 + 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html index 332e3943e..7667708a1 100644 --- a/vocab/credentials/v2/template.html +++ b/vocab/credentials/v2/template.html @@ -133,6 +133,15 @@ archives).

+
+

Specification of terms

+

+ In general the terms, i.e., properties and classes, are formally specified in Recommendation Track documents published by the W3C Verifiable Credentials Working Group or, for some deprecated or reserved terms, in Reports published by the W3C Credentials Community Group. In each of those cases the term description in this document contains a link to the specification itself (and the `rdfs:definedBy` property is used in the RDFS representations to refer to the formal specification). +

+

+ There are cases, however, when a local explanation is necessary to complement, or to replace, a reference to an external specification. This is the case when the term is necessary to provide a consistent structure to the RDFS vocabulary like, for example, when the term defines a common supertype for class instances that are used as objects of specific properties, or when RDF Graphs are involved. For such cases those extra definitions are included in the current document (and the `rdfs:comment` property is used to include them in the RDFS representations). +

+

Namespaces

This specification makes use of the following namespaces:

@@ -141,7 +150,7 @@

Namespaces

-

Term definitions

+

Regular terms

Class definitions

@@ -157,7 +166,7 @@

Definitions for individuals

-

Reserved term definitions

+

Reserved terms

All terms in this section are reserved. @@ -179,7 +188,7 @@

Reserved individuals

-

Deprecated term definitions

+

Deprecated terms

All terms in this section are deprecated, and are only kept in this vocabulary for backward compatibility.
New applications should not use them. diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index f425a22fc..bae565b04 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -59,6 +59,7 @@ class: - id: VerifiablePresentation defined_by: https://www.w3.org/TR/vc-data-model-2.0/#presentations label: Verifiable presentation + comment: A Presentation is data derived from one or more Credentials, issued by one or more `issuers`, that is shared with a specific `verifier`. A Verifiable Presentation is a tamper-evident Presentation encoded in such a way that authorship of the data can be trusted after a process of cryptographic verification. Certain types of verifiable presentations might contain data that is synthesized from, but do not contain, the original verifiable credentials (for example, zero-knowledge proofs). property: - id: credentialSchema From 45cabb74a1edb5b41a5103683bccf1d43aa3b704 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Wed, 26 Jul 2023 08:44:33 +0200 Subject: [PATCH 7/9] Fix grammar in specification of terms. Co-authored-by: Ted Thibodeau Jr --- vocab/credentials/v2/template.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html index 7667708a1..7942329f0 100644 --- a/vocab/credentials/v2/template.html +++ b/vocab/credentials/v2/template.html @@ -136,10 +136,10 @@

Specification of terms

- In general the terms, i.e., properties and classes, are formally specified in Recommendation Track documents published by the W3C Verifiable Credentials Working Group or, for some deprecated or reserved terms, in Reports published by the W3C Credentials Community Group. In each of those cases the term description in this document contains a link to the specification itself (and the `rdfs:definedBy` property is used in the RDFS representations to refer to the formal specification). + In general, the terms — i.e., the properties and classes — used in the VCDM are formally specified in Recommendation Track documents published by the W3C Verifiable Credentials Working Group or, for some deprecated or reserved terms, in Reports published by the W3C Credentials Community Group. In each case of such external definition, the term's description in this document contains a link to the relevant specification. Additionally, the `rdfs:definedBy` property in the RDFS representation(s) refers to the formal specification.

- There are cases, however, when a local explanation is necessary to complement, or to replace, a reference to an external specification. This is the case when the term is necessary to provide a consistent structure to the RDFS vocabulary like, for example, when the term defines a common supertype for class instances that are used as objects of specific properties, or when RDF Graphs are involved. For such cases those extra definitions are included in the current document (and the `rdfs:comment` property is used to include them in the RDFS representations). + In some cases, a local explanation is necessary to complement, or to replace, the definition found in an external specification. For instance, this is so when the term is needed to provide a consistent structure to the RDFS vocabulary, such as when the term defines a common supertype for class instances that are used as objects of specific properties, or when RDF Graphs are involved. For such cases, the extra definition is included in the current document (and the `rdfs:comment` property is used to include them in the RDFS representations).

From bc5c95775776844d8ed3d9ff75013f105feae15c Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Wed, 26 Jul 2023 18:28:52 +0200 Subject: [PATCH 8/9] Fix more grammar issues in template and vocabulary. Co-authored-by: Ted Thibodeau Jr --- vocab/credentials/v2/template.html | 4 ++-- vocab/credentials/v2/vocabulary.yml | 3 +-- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html index 7942329f0..1ef6d67e1 100644 --- a/vocab/credentials/v2/template.html +++ b/vocab/credentials/v2/template.html @@ -170,8 +170,8 @@

Reserved terms

All terms in this section are reserved. - Implementers may use these properties, but should expect them and/or their meanings to change during the process to - normatively specify them. + Implementers may use these properties, but should expect them and/or their meanings to change during the process of + normatively specifying them.

diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index bae565b04..55b65842c 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -33,7 +33,7 @@ class: label: JSON schema validator 2023 defined_by: https://www.w3.org/TR/vc-json-schema/#jsonschema2023 upper_value: cred:CredentialSchema - comment: A type of validator for the validation of Verifiable Credentials, based on JSON Schema. + comment: A type of validator for the validation of Verifiable Credentials that are based on JSON Schema. - id: RefreshService label: Refresh service @@ -59,7 +59,6 @@ class: - id: VerifiablePresentation defined_by: https://www.w3.org/TR/vc-data-model-2.0/#presentations label: Verifiable presentation - comment: A Presentation is data derived from one or more Credentials, issued by one or more `issuers`, that is shared with a specific `verifier`. A Verifiable Presentation is a tamper-evident Presentation encoded in such a way that authorship of the data can be trusted after a process of cryptographic verification. Certain types of verifiable presentations might contain data that is synthesized from, but do not contain, the original verifiable credentials (for example, zero-knowledge proofs). property: - id: credentialSchema From ee9a7ffb96a18794ac142166ef0421d7ddd74311 Mon Sep 17 00:00:00 2001 From: Ivan Herman Date: Wed, 19 Jul 2023 14:15:01 +0200 Subject: [PATCH 9/9] Remove trailing space, fix grammar in vocabulary. --- vocab/credentials/v2/template.html | 30 ++++++++++++++--------------- vocab/credentials/v2/vocabulary.yml | 23 +++++++++++----------- 2 files changed, 26 insertions(+), 27 deletions(-) diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html index 1ef6d67e1..0b7c893c1 100644 --- a/vocab/credentials/v2/template.html +++ b/vocab/credentials/v2/template.html @@ -139,7 +139,7 @@

Specification of terms

In general, the terms — i.e., the properties and classes — used in the VCDM are formally specified in Recommendation Track documents published by the W3C Verifiable Credentials Working Group or, for some deprecated or reserved terms, in Reports published by the W3C Credentials Community Group. In each case of such external definition, the term's description in this document contains a link to the relevant specification. Additionally, the `rdfs:definedBy` property in the RDFS representation(s) refers to the formal specification.

- In some cases, a local explanation is necessary to complement, or to replace, the definition found in an external specification. For instance, this is so when the term is needed to provide a consistent structure to the RDFS vocabulary, such as when the term defines a common supertype for class instances that are used as objects of specific properties, or when RDF Graphs are involved. For such cases, the extra definition is included in the current document (and the `rdfs:comment` property is used to include them in the RDFS representations). + In some cases, a local explanation is necessary to complement, or to replace, the definition found in an external specification. For instance, this is so when the term is needed to provide a consistent structure to the RDFS vocabulary, such as when the term defines a common supertype for class instances that are used as objects of specific properties, or when RDF Graphs are involved. For such cases, the extra definition is included in the current document (and the `rdfs:comment` property is used to include them in the RDFS representations).

@@ -155,33 +155,33 @@

Regular terms

Class definitions

- +

Property definitions

- +

Definitions for individuals

-
+
-

Reserved terms

- +

Reserved term definitions

+

All terms in this section are reserved. - Implementers may use these properties, but should expect them and/or their meanings to change during the process of - normatively specifying them. + Implementers may use these properties, but should expect them and/or their meanings to change during the process to + normatively specify them.

- +

Reserved classes

- +

Reserved properties

- +

Reserved individuals

@@ -190,22 +190,22 @@

Reserved individuals

Deprecated terms

-

All terms in this section are deprecated, and are only kept in this vocabulary for backward compatibility. +

All terms in this section are deprecated, and are only kept in this vocabulary for backward compatibility.
New applications should not use them.

Deprecated classes

- +

Deprecated properties

- +

Deprecated individuals

-
+
diff --git a/vocab/credentials/v2/vocabulary.yml b/vocab/credentials/v2/vocabulary.yml index 55b65842c..305711062 100644 --- a/vocab/credentials/v2/vocabulary.yml +++ b/vocab/credentials/v2/vocabulary.yml @@ -19,11 +19,11 @@ ontology: class: - id: CredentialEvidence label: Credential Evidence - comment: A Credential Evidence provides an evidence scheme that is used by the evidence property. This class serves as a supertype for specific evidence types. + comment: A Credential Evidence provides evidence schemes that are used by the evidence property. This class serves as a supertype for specific evidence types. - id: CredentialSchema label: Credential schema - comment: A Credential Schema provides a verifier with enough information to determine if the provided data conforms to the provided schema. This class serves as a supertype for specific schemas (e.g., JsonSchema2023). + comment: A Credential Schema provides verifiers with enough information to determine if the provided data conforms to the provided schema. This class serves as a supertype for specific schemas (e.g., JsonSchema2023). - id: CredentialStatus label: Credential status @@ -33,20 +33,19 @@ class: label: JSON schema validator 2023 defined_by: https://www.w3.org/TR/vc-json-schema/#jsonschema2023 upper_value: cred:CredentialSchema - comment: A type of validator for the validation of Verifiable Credentials that are based on JSON Schema. + comment: A type of validator for the validation of Verifiable Credentials, based on JSON Schema. - id: RefreshService label: Refresh service - comment: A Refresh Service is a mechanism that can be used by a software agent to retrieve an updated copy of a Verifiable Credential. This class serves as a supertype for specific refresh service types. + comment: A Refresh Service is a mechanism that can be utilized by software agents to retrieve an updated copy of a Verifiable Credential. This class serves as a supertype for specific refresh service types. - id: TermsOfUse label: Terms of use - comment: Terms of use reflect the policy/ies under which the issuer issued the credential or presentation. This class serves as a supertype for specific types of terms of use. + comment: Policy under which the creator issued the credential or presentation. This class serves as a supertype for specific types for terms of use. - - id: StatusList2021Entry - label: Status List 2021 Entry - deprecated: true - comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. Placeholder for now; this item may change to something else. + # - id: StatusList2021Entry + # label: Status List 2021 Entry + # comment: A Status List 2021 Entry provides issuers with a mechanism to provide status information for verifiable credentials. - id: VerifiableCredential defined_by: https://www.w3.org/TR/vc-data-model-2.0/#credentials @@ -99,7 +98,7 @@ property: domain: cred:VerifiablePresentation defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-holder range : IRI - + - id: issuanceDate label: Issuance date defined_by: https://www.w3.org/TR/2022/REC-vc-data-model-20220303/#issuance-date @@ -113,7 +112,7 @@ property: domain: cred:VerifiableCredential range: IRI comment: The value of this property must be a URL uniquely identifying the issuer. - + - id: refreshService label: Refresh service defined_by: https://www.w3.org/TR/vc-data-model-2.0/#defn-refreshService @@ -132,7 +131,7 @@ property: label: Service endpoint domain: cred:RefreshService range: IRI - comment: The value of this property must be a URL to the service endpoint associated with the subject. There is no URL yet in a VCWG document to define this term. + comment: The value of this property must be a URL to the service endpoint associated with the subject. There is no URL yet in a VCWG document to define this term. - id: termsOfUse label: Terms of use