Adding the jsonSchema property to the vocabulary

w3c · Sep 13, 2023 · 48deb8f · 48deb8f
1 parent d5c7a02
commit 48deb8f
Show file tree

Hide file tree

Showing 3 changed files with 508 additions and 437 deletions.
diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html
@@ -252,7 +252,7 @@ <h2>Diagram description</h2>
         <p>
           The diagram uses boxes, ellipses, and connecting lines with different "styles" (border color, end
           marker, line type) to differentiate their semantic meaning; these styles identify 
-          Property and Class used for shapes used for graph nodes, and Subclass, Domain, and Range for connector lines. 
+          Property, Class, or Datatype, used for shapes used for graph nodes, and Superclass, Domain Of, Range, and Graph Containment for connector lines. 
           These style names are used in the explanation text in what follows. 
         </p>
         <p>  
@@ -264,33 +264,36 @@ <h2>Diagram description</h2>
           On the left side of this column, there are four labeled ellipses, styled as Class. 
           These are, from top to bottom, "VerifiableCredential", "JsonSchemaCredential",
           "VerifiableCredentialGraph", and "VerifiablePresentation". 
-          There is also a single circle, not styled as Property or Class, labeled as "OR", and another box 
-          styled as a Property labeled as "verifiableCredential". 
+          There is also a small, unlabelled circle, as a crossing point for connector lines.
         </p>
         <p>
           The "VerifiableCredential" ellipse is connected through a connecting line
-          styled as Domain to the "credentialSchema", "credentialStatus", "credentialSubject",
+          styled as Domain Of to the "credentialSchema", "credentialStatus", "credentialSubject",
           "issuer", "evidence", "refreshService", "renderMethod", and "confidenceMethod" boxes. 
-          It is also related to the separate "OR" circle with a similar connecting line. 
-          The "VerifiablePresentation" ellipse is connected to the "OR" box, as well as the "holder" 
-          and "verifiableCredential" boxes with a similar connecting line styled as Domain. 
+          It is also related to the separate crossing point circle with a similar connecting line. 
+          The "VerifiablePresentation" ellipse is connected to the crossing point circle, as well as the "holder" 
+          and "verifiableCredential" boxes with a similar connecting line styled as Domain Of. 
           The OR box is connected to the "termsOfUse", "validFrom", and "validUntil" boxes with a connecting line styled as Domain. 
           The "verifiableCredential" box is connected to the "VerifiableCredentialGraph" ellipse with a connecting
           line styled as Range. 
           The ellipse "JsonSchemaCredential" is connected to the ellipse labelled "VerifiableCredential" with a 
-          connecting line styled as Subclass. 
-          Finally, the "VerifiableCredentialGraph" ellipse is connected, through a uniquely styled connector and with a text "contains" <em>on</em> the connector 
-          line, to the "VerifiableCredential" ellipse.
+          connecting line styled as Superclass. 
+          Finally, the "VerifiableCredentialGraph" ellipse is connected with a Graph Containment connector line 
+          to the "VerifiableCredential" ellipse.
         </p>
         <p>
           On the right hand side of the column there is an extra column of ellipses styled as "Class", and labeled as "CredentialSchema",
-          "CredentialStatus", "CredentialEvidence", "RefreshService", "ConfidenceMethod", and "TermsOfUse".
+          "CredentialStatus", "CredentialEvidence", "RefreshService", "RenderMethod", "ConfidenceMethod", and "TermsOfUse".
           The Property boxes labeled as "credentialSchema", "credentialStatus", "credentialEvidence,
-          "refreshService", "confidenceMethod", and "termsOfUse" are all connected by connecting lines styled as Range to these
+          "refreshService", "renderMethod", "confidenceMethod", and "termsOfUse" are all connected by connecting lines styled as Range to these
           ellipses, respectively. 
-          On the right hand side of the diagram there is one more ellipse styled as Class and labeled as
-          "JsonSchema", connected to the the ellipse labeled as "CredentialSchema" via a connecting line
-          styled as Subclass. 
+        </p>
+        <p>
+          Finally, on the far right hand side of the diagram there is one more ellipse styled as Class and labeled as
+          "JsonSchema", connected from the the ellipse labeled as "CredentialSchema" via a connecting line
+          styled as Superclass. This ellipse is also connected through a connector line styled as DomainOf to
+          a Property box labelled as "jsonSchema". Finally, this box is connected, via a Range connector line,
+          to a Datatype Shape labeled as "rdf:JSON". 
         </p>
       </details>
     </section>