Skip to content

Commit a45bb7b

Browse files
committed
Refactor Types section to clarify possible values.
1 parent 1920037 commit a45bb7b

File tree

1 file changed

+14
-22
lines changed

1 file changed

+14
-22
lines changed

index.html

Lines changed: 14 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1426,30 +1426,23 @@ <h3>Types</h3>
14261426
use type information to determine whether or not a provided
14271427
[=verifiable credential=] or [=verifiable presentation=] is appropriate
14281428
for the intended use case. This specification defines a `type`
1429-
[=property=] for the expression of type information. This type information
1430-
can be used during [=validation=] processes as described in Appendix
1431-
<a href="#validation"></a>.
1429+
[=property=] for the expression of object type information. This type
1430+
information can be used during [=validation=] processes as described in Appendix
1431+
[[[#validation-0]]].
14321432
</p>
14331433

14341434
<p>
1435-
[=Verifiable credentials=] and [=verifiable presentations=] MUST have a
1436-
`type` [=property=]. That is, any [=credential=] or
1437-
[=presentation=] that does not have `type` [=property=]
1438-
<em>is not [=verifiable=]</em>, so is neither a [=verifiable credential=]
1439-
nor a [=verifiable presentation=].
1435+
[=Verifiable credentials=] and [=verifiable presentations=] MUST express a
1436+
`type` [=property=] with an associated value.
14401437
</p>
14411438

14421439
<dl>
14431440
<dt><dfn class="export" data-lt="type|types">type</dfn></dt>
14441441
<dd>
1445-
The value of the `type` [=property=] MUST be, or map to (through
1446-
interpretation of the `@context` property), one or more [=URLs=].
1447-
If more than one [=URL=] is provided, the [=URLs=] MUST be interpreted
1448-
as an unordered set. Syntactic conveniences SHOULD be used to ease developer
1449-
usage. Such conveniences might include JSON-LD terms. It is RECOMMENDED that
1450-
each [=URL=] in the `type` be one which, if dereferenced, results
1451-
in a document containing machine-readable information about the
1452-
`type`.
1442+
The value of the `type` [=property=] MUST be one or more
1443+
<a href="https://www.w3.org/TR/json-ld/#dfn-term">terms</a> and/or absolute
1444+
[=URLs=] (<a data-cite="URL#absolute-url-string">absolute url string</a>). If
1445+
more than one value is provided, the order does not matter.
14531446
</dd>
14541447
</dl>
14551448

@@ -1526,7 +1519,7 @@ <h3>Types</h3>
15261519
</td>
15271520
<td>
15281521
A valid terms of use [=type=]. For example,<br>
1529-
`"type": "ExampleTermsPolicy"`)
1522+
`"type": "ExampleTermsPolicy"`
15301523
</td>
15311524
</tr>
15321525

@@ -1594,11 +1587,10 @@ <h3>Types</h3>
15941587
</ul>
15951588

15961589
<p>
1597-
This enables implementers to rely on values associated with the
1598-
`type` property for [=verification=] purposes. The expectation of
1599-
[=types=] and their associated properties should be documented in at least a
1600-
human-readable specification, and preferably, in an additional machine-readable
1601-
representation.
1590+
This enables implementers to rely on values associated with the `type` property
1591+
for [=verification=] purposes. [=Types=], and their associated properties, are
1592+
expected to be documented in at least a human-readable specification, and
1593+
preferably, in an additional machine-readable representation.
16021594
</p>
16031595

16041596
<p class="note">

0 commit comments

Comments
 (0)