Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing language/locale negotiation mechanism #946

Closed
aphillips opened this issue Mar 31, 2021 · 3 comments
Closed

Missing language/locale negotiation mechanism #946

aphillips opened this issue Mar 31, 2021 · 3 comments
Labels
Future Candidate Feature i18n-needs-resolution Issue the Internationalization Group has raised and looks for a response on.

Comments

@aphillips
Copy link

(throughout the spec, some examples follow)
https://www.w3.org/TR/2020/CR-payment-request-20201203/#payererrors-dictionary
https://www.w3.org/TR/2020/CR-payment-request-20201203/#paymentshippingoption-dictionary
https://www.w3.org/TR/2020/CR-payment-request-20201203/#show-method

Throughout the payment-request spec we note that natural language text values are returned. In our teleconference of 2021-03-25 we decided to group a number of pending issues into three buckets:

  • The need for language and direction metadata on natural language items (already tracked in payment-request Add dir/lang member on dictionaries whose content is displayed in browser UI #327)
  • The need for localizability of natural language fields (e.g. the ability to have more than one language present)
  • The need for a language negotiation mechanism so that the the API caller can receive natural language messages such as errors or labels in their preferred language/locale (if available)

This issue tracks the last of these. It is possible this is a duplicate of #650

For example, at #show-method in the NOTE under item # 18:

Note: Localization of the payment sheet

The API does not provide a way for developers to specify the language in which the payment sheet is presented to end users. As such, user agents will generally present the payment sheet using the user agent's default language. The working group is contemplating adding the ability for developers to specify the language of the payment sheet, and of specific PaymentItems, in a future version of this API.

The user agent's default language and the language of the rendering site or host page might not match. Usually items shown as part of the payment-initiating customer experience should match the language and locale of that experience. Defaulting to the user agent's locale would could thus produce a mixed language experience, which is undesirable.

Why not this version?

@marcoscaceres
Copy link
Member

Based on #956, leaving this open to address in a future version of the spec.

@aphillips, for our records, could you please indicate if i18n is satisfied with this course of action? - and if so, remove the "i18n-needs-resolution" label.

Please add any other labels the i18n WG needs to track this going forward.

@aphillips
Copy link
Author

I am satisfied by the current resolution.

Please do not remove the "i18n-needs-resolution" label. Closing the issue is sufficient (we then close our matching issue to indicate satisfaction). If you want to keep this open for "future", that's okay too. Basically the label informs PLH's tracking tool which issues were from HR and it lets us keep track of our issues. Any open issues will actually be reviewed and are not a blocker. Alternatively, you have my permission to change the label from "i18n-needs-resolution" to "i18n-tracker".

@ianbjacobs
Copy link
Collaborator

Sounds like the simplest is to close the issue here; thank you @aphillips

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Future Candidate Feature i18n-needs-resolution Issue the Internationalization Group has raised and looks for a response on.
Projects
None yet
Development

No branches or pull requests

3 participants