Skip to content

Commit 448c5e1

Browse files
Change "usage" to "use" throughout the specification.
Co-authored-by: Ted Thibodeau Jr <[email protected]>
1 parent 062e4b3 commit 448c5e1

File tree

1 file changed

+48
-48
lines changed

1 file changed

+48
-48
lines changed

index.html

Lines changed: 48 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -478,7 +478,7 @@ <h3>Ecosystem Overview</h3>
478478
UUIDs and [=verification material=], might just act as namespaces for
479479
identifiers. Examples of verifiable data registries include trusted databases,
480480
decentralized databases, government ID databases, and distributed ledgers. Often,
481-
more than one type of verifiable data registry utilized in an ecosystem.
481+
more than one type of verifiable data registry used in an ecosystem.
482482
</dd>
483483
</dl>
484484

@@ -1301,7 +1301,7 @@ <h3>Contexts</h3>
13011301
</dd>
13021302
</dl>
13031303

1304-
<pre class="example nohighlight" title="Usage of the @context property">
1304+
<pre class="example nohighlight" title="Use of the @context property">
13051305
{
13061306
<span class="highlight">"@context": [
13071307
"https://www.w3.org/ns/credentials/v2",
@@ -1392,7 +1392,7 @@ <h3>Identifiers</h3>
13921392
</dd>
13931393
</dl>
13941394

1395-
<pre class="example nohighlight vc" title="Usage of the id property"
1395+
<pre class="example nohighlight vc" title="Use of the id property"
13961396
data-vc-vm="https://university.example/issuers/565049#key-1">
13971397
{
13981398
"@context": [
@@ -1463,7 +1463,7 @@ <h3>Types</h3>
14631463
</dd>
14641464
</dl>
14651465

1466-
<pre class="example nohighlight vc" title="Usage of the type property"
1466+
<pre class="example nohighlight vc" title="Use of the type property"
14671467
data-vc-vm="https://university.example/issuers/565049#key-1">
14681468
{
14691469
"@context": [
@@ -1684,7 +1684,7 @@ <h3>Names and Descriptions</h3>
16841684
</dl>
16851685

16861686
<pre class="example nohighlight vc"
1687-
title="Usage of the name and description property"
1687+
title="Use of the name and description properties"
16881688
data-vc-vm="https://university.example/issuers/565049#key-1">
16891689
{
16901690
"@context": [
@@ -1732,7 +1732,7 @@ <h3>Names and Descriptions</h3>
17321732
</p>
17331733

17341734
<pre class="example nohighlight"
1735-
title="Usage of the name and description property">
1735+
title="Use of the name and description properties">
17361736
{
17371737
"@context": [
17381738
"https://www.w3.org/ns/credentials/v2",
@@ -1835,7 +1835,7 @@ <h3>Issuer</h3>
18351835
</dd>
18361836
</dl>
18371837

1838-
<pre class="example nohighlight vc" title="Usage of issuer property"
1838+
<pre class="example nohighlight vc" title="Use of the issuer property"
18391839
data-vc-vm="https://university.example/issuers/14#key-1">
18401840
{
18411841
"@context": [
@@ -1862,7 +1862,7 @@ <h3>Issuer</h3>
18621862
</p>
18631863

18641864
<pre class="example nohighlight vc"
1865-
title="Usage of issuer expanded property"
1865+
title="Expanded use of the issuer property"
18661866
data-vc-vm="did:example:76e12ec712ebc6f1c221ebfeb1f#key-1">
18671867
{
18681868
"@context": [
@@ -1921,7 +1921,7 @@ <h3>Credential Subject</h3>
19211921
</dl>
19221922

19231923
<pre class="example nohighlight vc"
1924-
title="Usage of the credentialSubject property"
1924+
title="Use of the credentialSubject property"
19251925
data-vc-vm="https://university.example/issuers/565049#key-1">
19261926
{
19271927
"@context": [
@@ -2020,7 +2020,7 @@ <h3>Validity Period</h3>
20202020
</dl>
20212021

20222022
<pre class="example nohighlight vc"
2023-
title="Usage of validFrom and validUntil property"
2023+
title="Use of the validFrom and validUntil properties"
20242024
data-vc-vm="https://university.example/issuers/14#key-1">
20252025
{
20262026
"@context": [
@@ -2094,7 +2094,7 @@ <h3>Status</h3>
20942094
</p>
20952095

20962096
<pre class="example nohighlight"
2097-
title="Usage of the status property">
2097+
title="Use of the status property">
20982098
{
20992099
"@context": [
21002100
"https://www.w3.org/ns/credentials/v2",
@@ -2127,7 +2127,7 @@ <h3>Status</h3>
21272127
</p>
21282128

21292129
<pre class="example nohighlight"
2130-
title="Usage of multiple entries for the status property">
2130+
title="Use of multiple entries for the status property">
21312131
{
21322132
"@context": [
21332133
"https://www.w3.org/ns/credentials/v2",
@@ -2253,7 +2253,7 @@ <h3>Data Schemas</h3>
22532253
</p>
22542254

22552255
<pre class="example nohighlight"
2256-
title="Usage of the credentialSchema property to perform JSON schema validation">
2256+
title="Using the credentialSchema property to perform JSON schema validation">
22572257
{
22582258
"@context": [
22592259
"https://www.w3.org/ns/credentials/v2",
@@ -2321,7 +2321,7 @@ <h3>Securing Mechanisms</h3>
23212321
</p>
23222322

23232323
<pre class="example nohighlight"
2324-
title="A verifiable credential utilizing an embedded proof">
2324+
title="A verifiable credential using an embedded proof">
23252325
{
23262326
"@context": [
23272327
"https://www.w3.org/ns/credentials/v2",
@@ -3212,7 +3212,7 @@ <h2>Integrity of Related Resources</h2>
32123212
</p>
32133213

32143214
<pre class="example nohighlight"
3215-
title="Usage of the relatedResource and digestSRI property">
3215+
title="Use of the relatedResource and digestSRI properties">
32163216
"relatedResource": [{
32173217
"id": "https://www.w3.org/ns/credentials/v2",
32183218
"digestSRI":
@@ -3225,7 +3225,7 @@ <h2>Integrity of Related Resources</h2>
32253225
</pre>
32263226

32273227
<pre class="example nohighlight"
3228-
title="Usage of the relatedResource and digestMultibase property">
3228+
title="Use of the relatedResource and digestMultibase properties">
32293229
"relatedResource": [{
32303230
"id": "https://www.w3.org/ns/credentials/v2",
32313231
"digestMultibase": "uEres1usWcWCmW7uolIW2uA0CjQ8iRV14eGaZStJL73Vz"
@@ -3280,7 +3280,7 @@ <h3>Refreshing</h3>
32803280
</dl>
32813281

32823282
<pre class="example nohighlight"
3283-
title="Usage of the refreshService property by an issuer">
3283+
title="Use of the refreshService property by an issuer">
32843284
{
32853285
"@context": [
32863286
"https://www.w3.org/2018/credentials/v1",
@@ -3325,7 +3325,7 @@ <h3>Refreshing</h3>
33253325
<h3>Terms of Use</h3>
33263326

33273327
<p>
3328-
Terms of use can be utilized by an [=issuer=] or a [=holder=] to
3328+
Terms of use can be used by an [=issuer=] or a [=holder=] to
33293329
communicate the terms under which a [=verifiable credential=] or
33303330
[=verifiable presentation=] was issued. The [=issuer=] places their terms
33313331
of use inside the [=verifiable credential=]. The [=holder=] places their
@@ -3374,7 +3374,7 @@ <h3>Terms of Use</h3>
33743374
</dl>
33753375

33763376
<pre class="example nohighlight"
3377-
title="Usage of the termsOfUse property by an issuer">
3377+
title="Use of the termsOfUse property by an issuer">
33783378
{
33793379
{
33803380
"@context": [
@@ -3432,9 +3432,9 @@ <h3>Terms of Use</h3>
34323432
<p>
34333433
This feature is expected to be used by government-issued [=verifiable
34343434
credentials=] to instruct digital wallets to limit their use to similar
3435-
government organizations in an attempt to protect citizens from unexpected usage
3435+
government organizations in an attempt to protect citizens from unexpected use
34363436
of sensitive data. Similarly, some [=verifiable credentials=] issued by private
3437-
industry are expected to limit usage to within departments inside the
3437+
industry are expected to limit use to within departments inside the
34383438
organization, or during business hours. Implementers are urged to read more
34393439
about this evolving feature in the appropriate section of the Verifiable
34403440
Credentials Implementation Guidelines [[?VC-IMP-GUIDE]] document.
@@ -3544,7 +3544,7 @@ <h3>Evidence</h3>
35443544
<p class="note"
35453545
title="Evidence has a different purpose from securing mechanisms">
35463546
The `evidence` [=property=] provides information that is different from and
3547-
information to the securing mechanism utilized. The `evidence` [=property=] is
3547+
information to the securing mechanism used. The `evidence` [=property=] is
35483548
used to express supporting information, such as documentary evidence, related to
35493549
the [=verifiable credential=]. In contrast, the securing mechanism is used to
35503550
express machine-verifiable mathematical proofs related to the authenticity of
@@ -3800,7 +3800,7 @@ <h3>Representing Time</h3>
38003800
<p>
38013801
This specification attempts to increase the number of universally recognized
38023802
combinations of dates and times, and reduce the potential for
3803-
misinterpretation of time values, by utilizing the
3803+
misinterpretation of time values, by using the
38043804
`dateTimeStamp` construction first established by the [<a
38053805
data-cite="XMLSCHEMA11-2#dateTimeStamp">XMLSCHEMA11-2</a>] specification. In
38063806
order to reduce misinterpretations between different time zones, all time values
@@ -3993,7 +3993,7 @@ <h3>Ecosystem Compatibility</h3>
39933993
a [=conforming document=].
39943994
</li>
39953995
<li>
3996-
SHOULD ensure that all semantics utilized in the transformed
3996+
SHOULD ensure that all semantics used in the transformed
39973997
[=conforming document=] follow best practices for Linked Data. See
39983998
Section [[[#getting-started]]], Section
39993999
[[[#extensibility]]], and Linked Data Best Practices [[?LD-BP]]
@@ -4004,7 +4004,7 @@ <h3>Ecosystem Compatibility</h3>
40044004
<p class="note" title="What constitutes a verifiable credential?">
40054005
Readers are advised that a digital credential is only considered compatible with
40064006
the W3C Verifiable Credentials ecosystem if it is a [=conforming document=]
4007-
and it utilizes at least one securing mechanism, as described by their
4007+
and it uses at least one securing mechanism, as described by their
40084008
respective requirements in this specification. While some communities might call
40094009
some digital credential formats that are not [=conforming documents=]
40104010
"verifiable credentials", doing so does NOT make that digital credential
@@ -4273,10 +4273,10 @@ <h3>Notable JSON-LD Features</h3>
42734273
<h3>Restrictions on JSON-LD</h3>
42744274

42754275
<p>
4276-
In order to increase interoperability, this specification restricts the usage of
4276+
In order to increase interoperability, this specification restricts the use of
42774277
JSON-LD representations of the data model. JSON-LD <a
42784278
href="https://www.w3.org/TR/json-ld/#compacted-document-form">compacted document
4279-
form</a> MUST be utilized for all representations of the data model using the
4279+
form</a> MUST be used for all representations of the data model using the
42804280
`application/vc` or `application/vp` media type.
42814281
</p>
42824282

@@ -4545,7 +4545,7 @@ <h2>Type-Specific Credential Processing</h2>
45454545
</p>
45464546

45474547
<p>
4548-
<dfn>General JSON-LD processing</dfn> is defined as a mechanism that utilizes a
4548+
<dfn>General JSON-LD processing</dfn> is defined as a mechanism that uses a
45494549
JSON-LD software library to process a [=conforming document=] by performing
45504550
various <a data-cite="?JSON-LD11#forms-of-json-ld">transformations</a>.
45514551
<dfn>Type-specific credential processing</dfn> is defined as a lighter-weight
@@ -4628,7 +4628,7 @@ <h2>Algorithms</h2>
46284628
<p>
46294629
This section contains algorithms that can be used by implementations to perform
46304630
common operations, such as [=verification=]. Conformance requirements phrased as
4631-
algorithms utilize normative concepts from the [[[INFRA]]] [[INFRA]]. See the
4631+
algorithms use normative concepts from the [[[INFRA]]] [[INFRA]]. See the
46324632
section on <a data-cite="INFRA#algorithm-conformance">Algorithm Conformance</a>
46334633
in the [[[INFRA]]] for more guidance on implementation requirements.
46344634
</p>
@@ -5018,7 +5018,7 @@ <h3>Identifier-Based Correlation</h3>
50185018

50195019
<p>
50205020
Similarly, disclosing the [=credential=] identifier (as in
5021-
[[[#example-usage-of-the-id-property]]]) can lead to situations where multiple
5021+
[[[#example-use-of-the-id-property]]]) can lead to situations where multiple
50225022
[=verifiers=], or an [=issuer=] and a [=verifier=], can collude to correlate the
50235023
[=holder=].
50245024
</p>
@@ -5308,7 +5308,7 @@ <h3>Bearer Credentials</h3>
53085308
</p>
53095309

53105310
<pre class="example nohighlight vc"
5311-
title="Usage of issuer properties"
5311+
title="Use of issuer properties"
53125312
data-vc-vm="https://university.example/issuers/14#keys-1">
53135313
{
53145314
"@context": [
@@ -5593,11 +5593,11 @@ <h3>Patterns of Use</h3>
55935593
even compatible with necessary use. Sometimes, correlation is a requirement.
55945594
</p>
55955595
<p>
5596-
For example, in some prescription drug monitoring programs, usage monitoring is
5597-
a requirement. Enforcement entities need to be able to confirm that individuals
5596+
For example, in some prescription drug monitoring programs, monitoring prescription
5597+
use is a requirement. Enforcement entities need to be able to confirm that individuals
55985598
are not cheating the system to get multiple prescriptions for controlled
5599-
substances. This statutory or regulatory need to correlate usage overrides
5600-
individual privacy concerns.
5599+
substances. This statutory or regulatory need to correlate prescription
5600+
use overrides individual privacy concerns.
56015601
</p>
56025602

56035603
<p>
@@ -5609,8 +5609,8 @@ <h3>Patterns of Use</h3>
56095609
</p>
56105610

56115611
<p>
5612-
Privacy violations of [=verifiable credential=] usage occur when unintended or
5613-
unexpected correlation arises from the presentation of those
5612+
Privacy violations related to the use of [=verifiable credentials=] occur when
5613+
unintended or unexpected correlation arises from the presentation of those
56145614
[=verifiable credentials=].
56155615
</p>
56165616
</section>
@@ -6198,7 +6198,7 @@ <h3>Code Injection</h3>
61986198
processing language and base direction information.
61996199
</li>
62006200
<li>
6201-
It increases the security attack surface when utilizing this data model,
6201+
It increases the security attack surface when using this data model,
62026202
because naively processing HTML could result in the execution of a `script`
62036203
tag that an attacker injected at some point during the data production process.
62046204
</li>
@@ -6227,13 +6227,13 @@ <h2>Accessibility Considerations</h2>
62276227
makes this information unusable by a large subset of the population. It is
62286228
important to follow accessibility guidelines and standards, such as [[WCAG21]],
62296229
to ensure that all people, regardless of ability, can make use of this data.
6230-
This is especially important when establishing systems utilizing cryptography,
6230+
This is especially important when establishing systems using cryptography,
62316231
which have historically created problems for assistive technologies.
62326232
</p>
62336233

62346234
<p>
62356235
This section details the general accessibility considerations to take into
6236-
account when utilizing this data model.
6236+
account when using this data model.
62376237
</p>
62386238

62396239
<section class="informative">
@@ -6247,7 +6247,7 @@ <h3>Data First Approaches</h3>
62476247
</p>
62486248

62496249
<p>
6250-
When utilizing this data model to create [=verifiable credentials=], it is
6250+
When using this data model to create [=verifiable credentials=], it is
62516251
suggested that data model designers use a <em>data first</em> approach. For
62526252
example, given the choice of using data or a graphical image to depict a
62536253
[=credential=], designers should express every element of the image, such as
@@ -6285,7 +6285,7 @@ <h2>Internationalization Considerations</h2>
62856285

62866286
<p>
62876287
This section outlines general internationalization considerations to take into
6288-
account when utilizing this data model and is intended to highlight specific
6288+
account when using this data model and is intended to highlight specific
62896289
parts of the <em>Strings on the Web: Language and Direction Metadata</em>
62906290
document [[STRING-META]] that implementers might be interested in reading.
62916291
</p>
@@ -6441,9 +6441,9 @@ <h2>Validation</h2>
64416441
While this specification does not provide conformance criteria for the process
64426442
of the [=validation=] of [=verifiable credentials=] or
64436443
[=verifiable presentations=], readers might be curious about how the
6444-
information in this data model is expected to be utilized by [=verifiers=]
6444+
information in this data model is expected to be used by [=verifiers=]
64456445
during the process of [=validation=]. This section captures a selection of
6446-
conversations held by the Working Group related to the expected usage of the
6446+
conversations held by the Working Group related to the expected use of the
64476447
properties in this specification by [=verifiers=].
64486448
</p>
64496449

@@ -6781,7 +6781,7 @@ <h3>Base Context</h3>
67816781
</p>
67826782
<p>
67836783
It is strongly advised that all JSON-LD Context URLs used by an
6784-
application utilize the same mechanism, or a functionally equivalent mechanism,
6784+
application use the same mechanism, or a functionally equivalent mechanism,
67856785
to ensure end-to-end security. Implementations are expected to throw errors
67866786
if a cryptographic hash value for a resource does not match the expected hash
67876787
value.
@@ -7055,7 +7055,7 @@ <h3>Differences between Contexts, Types, and CredentialSchemas</h3>
70557055
value could make it more difficult for verifiers to inform the holder which
70567056
[=verifiable credential=] they require. When a [=verifiable credential=]
70577057
has multiple subtypes, listing all of them in the `type`
7058-
property is sensible. The usage of the `type` property in a
7058+
property is sensible. The use of the `type` property in a
70597059
[[JSON-LD11]] representation of a [=verifiable credential=] enables to enforce
70607060
the semantics of the [=verifiable credential=] because the machine is able to
70617061
check the semantics. With [[JSON-LD11]], the technology is not only describing the
@@ -7462,7 +7462,7 @@ <h2>Revision History</h2>
74627462
</li>
74637463
<li>
74647464
Ensure that `dateTimeStamp` is used for time values. Provide further guidance
7465-
on proper usage of time values and timezones.
7465+
on proper use of time values and timezones.
74667466
</li>
74677467
<li>
74687468
Make `validFrom` optional.
@@ -7560,7 +7560,7 @@ <h2>Revision History</h2>
75607560
<li>
75617561
Update previous normative references that pointed to RFC3339 for date-time
75627562
details to now normatively reference the date-time details described in
7563-
XMLSCHEMA11-2 which more accurately reflects the usage in examples and
7563+
XMLSCHEMA11-2 which more accurately reflect date-time use in examples and
75647564
libraries.
75657565
</li>
75667566

0 commit comments

Comments
 (0)