Skip to content

Commit cdcfe94

Browse files
mspornydlongleyTallTed
authored
Fix grammar in Verifiable Credential Graph section.
Co-authored-by: Dave Longley <[email protected]> Co-authored-by: Ted Thibodeau Jr <[email protected]>
1 parent 61fd882 commit cdcfe94

File tree

1 file changed

+16
-17
lines changed

1 file changed

+16
-17
lines changed

index.html

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2179,9 +2179,7 @@ <h3>Presentations</h3>
21792179
<dd>
21802180
The <code>verifiableCredential</code> <a>property</a> MAY be present. The value
21812181
MUST be an array of one or more <a href="#verifiable-credential-graphs">
2182-
verifiable credential graphs</a>, or <a href="#verifiable-credential-graphs">
2183-
verifiable credential graphs</a> that are derived from
2184-
<a>verifiable credentials</a>, in a cryptographically <a>verifiable</a> format.
2182+
verifiable credential graphs</a> in a cryptographically <a>verifiable</a> format.
21852183
See Section <a href="#verifiable-credential-graphs"></a> for further details on
21862184
this topic.
21872185
</dd>
@@ -2226,7 +2224,7 @@ <h3>Presentations</h3>
22262224

22272225
<p>
22282226
The contents of the <code>verifiableCredential</code> <a>property</a> shown
2229-
above are <a>verifiable credential</a> graphs, as described by this
2227+
above are <a href="#verifiable-credential-graphs">verifiable credential graphs</a>, as described by this
22302228
specification. The contents of the <code>proof</code> <a>property</a> are proof
22312229
graphs, as described by the Data Integrity [[VC-DATA-INTEGRITY]] specification.
22322230
An example of a <a>verifiable presentation</a> using the JWT proof mechanism is
@@ -2244,26 +2242,27 @@ <h4>Verifiable Credential Graphs</h4>
22442242
example, if one has two <a>verifiable credentials</a>, each containing an
22452243
object of the following form: `{"type": "Person", "name": "Jane Doe"}`, it is
22462244
not possible to tell if one object is describing the same person as the other
2247-
object. In other words, prematurely merging data between two
2248-
<a>verifiable credentials</a> can lead to a corrupted data model.
2245+
object. In other words, merging data between two <a>verifiable credentials</a>
2246+
without confirming that they are discussing the same entities and/or properties,
2247+
can lead to a corrupted data set.
22492248
</p>
22502249

22512250
<p>
2252-
In order to ensure that data from different <a>verifiable credentials</a> are
2251+
To ensure that data from different <a>verifiable credentials</a> are
22532252
not accidentally co-mingled, the concept of a
2254-
<dfn class="lint-ignore">verifiable credential graph</dfn> is utilized to
2255-
encapsulate the <a>verifiable credential</a>. The value(s) associated with the
2256-
`verifiableCredential` property on a <a>presentation</a> is of type
2253+
<dfn class="lint-ignore">verifiable credential graph</dfn> is used to
2254+
encapsulate each <a>verifiable credential</a>. Each value associated with the
2255+
`verifiableCredential` property of a <a>presentation</a> is of type
22572256
<dfn class="lint-ignore">VerifiableCredentialGraph</dfn>. Using this type has a
22582257
concrete effect on full JSON-LD processing, which properly separates graph
2259-
node identifiers in one graph vs. another graph. Implementers that do not do
2260-
full JSON-LD processing will need to keep this in mind if they merge data
2261-
from one <a>verifiable credential</a> into another, such as when the
2262-
`credentialSubject.id` is the same in both <a>verifiable credentials</a> but
2258+
node identifiers in one graph from those in another graph. Implementers that do not
2259+
fully process JSON-LD will need to keep this in mind if they merge data
2260+
from one <a>verifiable credential</a> with data from another, such as when the
2261+
`credentialSubject.id` is the same in both <a>verifiable credentials</a>, but
22632262
the object might contain objects of the "Jane Doe" form described in the
2264-
previous paragraph. Care is to be taken to not merge objects that use
2265-
document-relative identifiers, such as blank node identifiers, and only
2266-
perform merges when global identifiers, such as URLs, are utilized.
2263+
previous paragraph. It is important to not merge objects that use
2264+
document-relative identifiers, such as blank node identifiers, and to only
2265+
perform merges when global identifiers, such as URLs, are used.
22672266
</p>
22682267
</section>
22692268

0 commit comments

Comments
 (0)