Apply suggestions from code review

All of Ted's changes Co-authored-by: Ted Thibodeau Jr <[email protected]>
w3c · Sep 7, 2023 · 895c4e5 · 895c4e5
1 parent 87cfd70
commit 895c4e5
Showing 1 changed file with 23 additions and 19 deletions.
diff --git a/vocab/credentials/v2/template.html b/vocab/credentials/v2/template.html
@@ -252,7 +252,8 @@ <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, Class, or Datatype, used for shapes used for graph nodes, and Superclass, Domain Of, Range, and Graph Containment for connector lines. 
+          Property, Class, or Datatype, via the shapes used for the graph nodes, and Superclass, Domain Of,
+          Range, or Contains, via the styles of the connecting lines. 
           These style names are used in the explanation text in what follows. 
         </p>
         <p>  
@@ -264,36 +265,39 @@ <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 small, unlabelled circle, as a crossing point for connector lines.
+          There is also a small, unlabeled circle, which serves as an intersection point for connector
+          lines, with two pointing in, and three pointing out.
         </p>
         <p>
-          The "VerifiableCredential" ellipse is connected through a connecting line
-          styled as Domain Of to the "credentialSchema", "credentialStatus", "credentialSubject",
-          "issuer", "evidence", "refreshService", "renderMethod", and "confidenceMethod" boxes. 
-          It is also related to the separate crossing point circle with a similar connecting line. 
+          The "VerifiableCredential" ellipse is connected to the "credentialSchema", "credentialStatus",
+          "credentialSubject", "issuer", "evidence", "refreshService", "renderMethod", and "confidenceMethod"
+          boxes, through connecting lines styled as Domain Of. 
+          It is also connected to the crossing point circle with a similar connecting line,
+          styled as Domain Of.
           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. 
+          and "verifiableCredential" boxes, with a similar connecting line, styled as Domain Of. 
+          The crossing point circle is connected to the "termsOfUse", "validFrom", and "validUntil" boxes with a connecting line styled as Domain Of.
           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 
+          The "JsonSchemaCredential" ellipse is connected to the "VerifiableCredential" ellipse with a 
           connecting line styled as Superclass. 
-          Finally, the "VerifiableCredentialGraph" ellipse is connected with a Graph Containment connector line 
-          to the "VerifiableCredential" ellipse.
+          Finally, the "VerifiableCredentialGraph" ellipse is connected to the "VerifiableCredential"
+          ellipse with a connector line styled as Contains.
         </p>
         <p>
-          On the right hand side of the column there is an extra column of ellipses styled as "Class", and labeled as "CredentialSchema",
+          On the right side of the column, there is another column of ellipses, styled as "Class", and labeled as "CredentialSchema",
           "CredentialStatus", "CredentialEvidence", "RefreshService", "RenderMethod", "ConfidenceMethod", and "TermsOfUse".
           The Property boxes labeled as "credentialSchema", "credentialStatus", "credentialEvidence,
-          "refreshService", "renderMethod", "confidenceMethod", and "termsOfUse" are all connected by connecting lines styled as Range to these
-          ellipses, respectively. 
+          "refreshService", "renderMethod", "confidenceMethod", and "termsOfUse" are respectively
+          connected to those Class ellipses, with connecting lines styled as Range. 
         </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". 
+          Finally, the "CredentialSchema" ellipse is connected to one more ellipse, on the far right
+          side of the diagram, styled as Class and labeled as "JsonSchema", with a connecting line
+          styled as Superclass. This "JsonSchema" ellipse is also connected to a Property box
+          labeled as "jsonSchema", through a connector line styled as Domain Of. This "jsonSchema"
+          box is connected to a Datatype shape labeled as "rdf:JSON", with a connecting line
+          styled as Range. 
         </p>
       </details>
     </section>