Skip to content

Commit

Permalink
Clarify requirements for language headers (#136)
Browse files Browse the repository at this point in the history
Based on our discussion in the September meeting:

https://etherpad.lobid.org/p/reconciliation-september-2023
  • Loading branch information
fsteeg committed Dec 12, 2023
1 parent 70eb13f commit d2ca1e6
Showing 1 changed file with 4 additions and 2 deletions.
6 changes: 4 additions & 2 deletions draft/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -917,8 +917,10 @@ <h2>Internationalization Considerations</h2>
<section>
<h3>Language of the intended audience</h3>
<p>
Following [[RFC9110]], services SHOULD support the <code>Accept-Language</code> header to let clients specify the preferred language in which user-facing text is returned. The language(s) requested by clients MUST be well-formed [[BCP 47]] language tags.
Services SHOULD use the <code>Content-Language</code> header in their responses to expose the language(s) of the intended audience(s) of each response. Services MUST return valid (i.e. found in the [[IANA Language Subtag Registry]]) [[BCP 47]] tags.
Following [[RFC9110]], services SHOULD support the <code>Accept-Language</code> header to let clients specify the preferred language in which user-facing text is returned.
If clients set the <code>Accept-Language</code> header, the requested language(s) MUST be provided as <em>well-formed</em> [[BCP 47]] language tags.
Services MAY use the <code>Content-Language</code> header in their responses to expose the language(s) of the intended audience(s) of each response.
If services set the <code>Content-Language</code> header, they MUST use <em>valid</em> (i.e. found in the [[IANA Language Subtag Registry]]) [[BCP 47]] tags.
</p>
<p>
Examples of user-facing text in service responses are: the name of the service and the name of property configuration fields in the manifest, the name and description of entities, types and properties,
Expand Down

0 comments on commit d2ca1e6

Please sign in to comment.