Skip to content

Commit 4c3a158

Browse files
committed
Reflow and clarify Media Type Precision section.
1 parent 8d6bd23 commit 4c3a158

File tree

1 file changed

+17
-18
lines changed

1 file changed

+17
-18
lines changed

index.html

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4436,8 +4436,8 @@ <h3>Media Type Precision</h3>
44364436

44374437
<p>
44384438
At times, developers or systems might use lower precision media types to convey
4439-
[=verifiable credentials=] or [=verifiable presentations=]. Some of the
4440-
reasons for use of lower precision media types include:
4439+
[=verifiable credentials=] or [=verifiable presentations=]. Some of the reasons
4440+
for use of lower precision media types include:
44414441
</p>
44424442

44434443
<ul>
@@ -4461,11 +4461,10 @@ <h3>Media Type Precision</h3>
44614461
Implementers are urged to not raise errors when it is possible to determine the
44624462
intended media type from a payload, provided that the media type used is
44634463
acceptable in the given protocol. For example, if an application only accepts
4464-
payloads that conform to the rules associated with the `application/vc`
4465-
media type, but the payload is tagged with `application/json` or
4466-
`application/ld+json` instead, the application might perform the following
4467-
steps to determine whether the payload also conforms to the higher precision
4468-
media type:
4464+
payloads that conform to the rules associated with the `application/vc` media
4465+
type, but the payload is tagged with `application/json` or `application/ld+json`
4466+
instead, the application might perform the following steps to determine whether
4467+
the payload also conforms to the higher precision media type:
44694468
</p>
44704469

44714470
<ol>
@@ -4477,18 +4476,18 @@ <h3>Media Type Precision</h3>
44774476
`https://www.w3.org/2018/credentials/v2`.
44784477
</li>
44794478
<li>
4480-
Assume an `application/vp` media type if the JSON document contains a
4481-
top-level `type` property containing a `VerifiablePresentation` element. Additional
4479+
Assume an `application/vp` media type if the JSON document contains a top-level
4480+
`type` property containing a `VerifiablePresentation` element. Additional
44824481
subsequent checks are still expected to be performed (according to this
4483-
specification) to ensure the payload expresses a conformant Verifiable
4484-
Presentation.
4482+
specification) to ensure the payload expresses a conformant
4483+
[=verifiable presentation=].
44854484
</li>
44864485
<li>
4487-
Assume an `application/vc` media type if the JSON document contains a
4488-
top-level `type` property containing a `VerifiableCredential` element. Additional
4486+
Assume an `application/vc` media type if the JSON document contains a top-level
4487+
`type` property containing a `VerifiableCredential` element. Additional
44894488
subsequent checks are still expected to be performed (according to this
4490-
specification) to ensure the payload expresses a conformant Verifiable
4491-
Credential.
4489+
specification) to ensure the payload expresses a conformant
4490+
[=verifiable credential=].
44924491
</li>
44934492
</ol>
44944493

@@ -4507,9 +4506,9 @@ <h3>Media Type Precision</h3>
45074506
<p>
45084507
HTTP clients and servers use media types associated with [=verifiable
45094508
credentials=] and [=verifiable presentations=] in accept headers and when
4510-
indicating content types. Nonetheless, HTTP servers might ignore the accept
4511-
header and return another content type, or return an error code such as
4512-
<a data-cite="RFC7231#section-6.5.13">`415 Unsupported Media Type`</a>.
4509+
indicating content types. Implementers are warned that HTTP servers might ignore
4510+
the accept header and return another content type, or return an error code such
4511+
as <a data-cite="RFC7231#section-6.5.13">`415 Unsupported Media Type`</a>.
45134512
</p>
45144513
</section>
45154514
</section>

0 commit comments

Comments
 (0)