Skip to content

Commit 8477ab2

Browse files
committed
Clean up grammar and flow in IANA Considerations section.
1 parent ffe0e29 commit 8477ab2

File tree

1 file changed

+32
-29
lines changed

1 file changed

+32
-29
lines changed

Diff for: index.html

+32-29
Original file line numberDiff line numberDiff line change
@@ -7144,8 +7144,8 @@ <h2>IANA Considerations</h2>
71447144
<section id="vc-ld-media-type">
71457145
<h2>application/vc</h2>
71467146
<p>
7147-
This specification registers the `application/vc` Media Type specifically for
7148-
identifying documents conforming to the Verifiable Credentials format.
7147+
This specification registers the `application/vc` media type specifically for
7148+
identifying documents conforming to the [=verifiable credentials=] format.
71497149
</p>
71507150
<table>
71517151
<tr>
@@ -7163,15 +7163,15 @@ <h2>application/vc</h2>
71637163
<tr>
71647164
<td>Encoding considerations: </td>
71657165
<td>
7166-
Resources that use the "`application/vc`" Media Type are required to conform to
7167-
all of the requirements for the "`application/ld+json`" Media Type and are
7166+
Resources that use the `application/vc` media type are required to conform to
7167+
all of the requirements for the `application/ld+json` media type and are
71687168
therefore subject to the same encoding considerations specified in Section 11 of
7169-
[[RFC7159]].
7169+
[[[RFC7159]]].
71707170
</td>
71717171
</tr>
71727172
<tr>
71737173
<td>Security considerations: </td>
7174-
<td>As defined in this specification.</td>
7174+
<td>As defined in the [[[VC-DATA-MODEL-2.0]]].</td>
71757175
</tr>
71767176
<tr>
71777177
<td>Contact: </td>
@@ -7183,32 +7183,33 @@ <h2>application/vc</h2>
71837183
</table>
71847184

71857185
<p>
7186-
Note that while the Verifiable Credentials format uses JSON-LD conventions,
7187-
there are a number of constraints and additional requirements for Verifiable
7188-
Credential implementations that justify the use of a specific media type.
7186+
Note that while the [=verifiable credentials=] format uses JSON-LD conventions,
7187+
there are a number of constraints and additional requirements for [=verifiable
7188+
credential=] implementations that justify the use of a specific media type.
71897189
</p>
71907190

71917191
<p>
7192-
This media type can be used in an [=enveloping proof=] to denote the enveloped payload.
7192+
This media type can be used in an [=enveloping proof=] to denote the enveloped
7193+
payload.
71937194
</p>
71947195

71957196
<p>
71967197
The credential is expected to be a valid
71977198
<a data-cite="JSON-LD11#dfn-json-ld-document">JSON-LD document</a>.
7198-
Credentials served with the "`application/vc`" media type are expected
7199-
to have all [[JSON-LD11]] context information, including references to
7199+
[=Verifiable credentials=] served with the `application/vc` media type are expected
7200+
to have all [[[JSON-LD11]]] context information, including references to
72007201
external contexts, within the body of the document. Contexts linked via a
72017202
`http://www.w3.org/ns/json-ld#context` HTTP Link Header
72027203
(see <a data-cite="JSON-LD11#interpreting-json-as-json-ld">Section 6.1</a>
7203-
of [[JSON-LD11]]) are ignored.
7204+
of [[[JSON-LD11]]]) are ignored.
72047205
</p>
72057206
</section>
72067207

72077208
<section id="vp-ld-media-type">
72087209
<h2>application/vp</h2>
72097210
<p>
7210-
This specification registers the `application/vp` Media Type specifically for
7211-
identifying documents conforming to the Verifiable Presentations format.
7211+
This specification registers the `application/vp` media type specifically for
7212+
identifying documents conforming to the [=verifiable presentations=] format.
72127213
</p>
72137214
<table>
72147215
<tr>
@@ -7226,15 +7227,15 @@ <h2>application/vp</h2>
72267227
<tr>
72277228
<td>Encoding considerations: </td>
72287229
<td>
7229-
Resources that use the "`application/vp`" Media Type are required to conform to
7230-
all of the requirements for the "`application/ld+json`" Media Type and are
7230+
Resources that use the `application/vp` media type are required to conform to
7231+
all of the requirements for the `application/ld+json` media type and are
72317232
therefore subject to the same encoding considerations specified in Section 11 of
7232-
[[RFC7159]].
7233+
[[[RFC7159]]].
72337234
</td>
72347235
</tr>
72357236
<tr>
72367237
<td>Security considerations: </td>
7237-
<td>As defined in this specification.</td>
7238+
<td>As defined in [[[VC-DATA-MODEL-2.0]]].</td>
72387239
</tr>
72397240
<tr>
72407241
<td>Contact: </td>
@@ -7246,22 +7247,24 @@ <h2>application/vp</h2>
72467247
</table>
72477248

72487249
<p>
7249-
Note that while the Verifiable Credentials format uses JSON-LD conventions,
7250-
there are a number of constraints and additional requirements for Verifiable
7251-
Credential implementations that justify the use of a specific media type.
7250+
Note that while the [=verifiable presentations=] format uses JSON-LD
7251+
conventions, there are a number of constraints and additional requirements for
7252+
[=verifiable presentation=] implementations that justify the use of a specific
7253+
media type.
72527254
</p>
72537255

72547256
<p>
7255-
This media type can be used in an [=enveloping proof=] to denote the enveloped payload.
7257+
This media type can be used in an [=enveloping proof=] to denote the enveloped
7258+
payload.
72567259
</p>
72577260
<p>
72587261
The presentation is expected to be a valid
7259-
<a data-cite="JSON-LD11#dfn-json-ld-document">JSON-LD document</a>.
7260-
Presentations served with the "`application/vp`" media type are expected
7261-
to have all [[JSON-LD11]] context information, including references to
7262-
external contexts, within the body of the document. Contexts linked via a
7263-
`http://www.w3.org/ns/json-ld#context` HTTP Link Header
7264-
(see <a data-cite="JSON-LD11#interpreting-json-as-json-ld">Section 6.1</a>
7262+
<a data-cite="JSON-LD11#dfn-json-ld-document">JSON-LD document</a>. [=Verifiable
7263+
presentations=] served with the `application/vp` media type are expected to have
7264+
all [[[JSON-LD11]]] context information, including references to external
7265+
contexts, within the body of the document. Contexts linked via a
7266+
`http://www.w3.org/ns/json-ld#context` HTTP Link Header (see <a
7267+
data-cite="JSON-LD11#interpreting-json-as-json-ld">Section 6.1</a>
72657268
of [[JSON-LD11]]) are ignored.
72667269
</p>
72677270
</section>

0 commit comments

Comments
 (0)