Skip to content

Commit

Permalink
Fix grammar in media types section.
Browse files Browse the repository at this point in the history
Co-authored-by: Ted Thibodeau Jr <[email protected]>
  • Loading branch information
msporny and TallTed committed Nov 15, 2024
1 parent e21ef87 commit 00fe4c7
Showing 1 changed file with 14 additions and 14 deletions.
28 changes: 14 additions & 14 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -3032,7 +3032,7 @@ <h3>Media Types</h3>
followed when defining or using media types with [=DID documents=].
</p>
<p>
There are one media type associated with the core data model, which is
There is one media type associated with the core data model, which is
listed in Section [[[#iana-considerations]]]:
`application/did`.
</p>
Expand All @@ -3041,8 +3041,8 @@ <h3>Media Types</h3>
<h3>Media Type Precision</h3>

<p>
At times, developers or systems might use lower precision media types to convey
[=DID documents=]. Some of the reasons for use of lower precision media types
At times, developers or systems might use lower-precision media types to convey
[=DID documents=]. Some of the reasons for use of lower-precision media types
include:
</p>

Expand All @@ -3064,13 +3064,13 @@ <h3>Media Type Precision</h3>
</ul>

<p>
Implementers are urged to not raise errors when it is possible to determine the
intended media type from a payload, provided that the media type used is
Implementers are urged to avoid raising errors when it is possible to determine
the intended media type from the payload, provided that the media type used is
acceptable in the given protocol. For example, if an application only accepts
payloads that conform to the rules associated with the `application/did` media
type, but the payload is tagged with `application/json` or `application/ld+json`
instead, the application might perform the following steps to determine whether
the payload also conforms to the higher precision media type:
type, but the payload is tagged with the lower-precision `application/json` or
`application/ld+json`, the application might perform the following steps to
determine whether the payload also conforms to the higher-precision media type:
</p>

<ol>
Expand All @@ -3089,21 +3089,21 @@ <h3>Media Type Precision</h3>
</ol>

<p>
Whenever possible, implementers are advised to use the most precise (the highest
Whenever possible, implementers are advised to use the most precise (the highest-
precision) media type for all payloads defined by this specification.
Implementers are also advised to recognize that a payload tagged with a lower
Implementers are also advised to recognize that a payload tagged with a lower-
precision media type does not mean that the payload does not meet the rules
necessary to tag it with a higher precision type. Similarly, a payload tagged
with a higher precision media type does not mean that the payload will meet the
necessary to tag it with a higher-precision type. Similarly, a payload tagged
with a higher-precision media type does not mean that the payload will meet the
requirements associated with the media type. Receivers of payloads, regardless
of their associated media type, are expected to perform appropriate checks to
ensure that payloads conform with the requirements for their use in a given
system.
</p>
<p>
HTTP clients and servers use media types associated with [=DID documents=] in
accept headers and when indicating content types. Implementers are warned that
HTTP servers might ignore the accept header and return another content type, or
`Accept:` headers and when indicating content types. Implementers are warned that
HTTP servers might ignore the `Accept:` header and return another content type, or
return an error code such as <a data-cite="RFC7231#section-6.5.13">`415
Unsupported Media Type`</a>.
</p>
Expand Down

0 comments on commit 00fe4c7

Please sign in to comment.