Add internationalization support for human readable labels (#971)

ianbjacobs · marcoscaceres · web-flow · commit ff5e72575924 · 2022-01-03T10:04:03.000-06:00
* add candidate corrections for two strings that lack language/direction. * Apply suggestions from code review Co-authored-by: Marcos Cáceres <marcos@marcosc.com> * Apply suggestions from code review Co-authored-by: Marcos Cáceres <marcos@marcosc.com> * use different css class for additions * Apply suggestions from code review * Updated pull request based on 26 October 2021 WPWG discussion https://www.w3.org/2021/10/26-wpwg-minutes#t03 * removed sentence that was affected by other edit Co-authored-by: Marcos Cáceres <marcos@marcosc.com>
diff --git a/index.html b/index.html
@@ -920,11 +920,7 @@ <h2>
                 The API does not currently provide a way for developers to
                 specify the language and base direction in which the payment
                 sheet is presented to end users. Instead, the API relies on
-                localization information inherited from the document. The
-                working group is considering support for requesting specific
-                localization of the user interface and of individual
-                {{PaymentItems}} and user-facing error messages in a future
-                version of this API.
+                localization information inherited from the document.
               </p>
             </aside>
           </li>
@@ -1730,6 +1726,15 @@ <h2>
         <dd>
           A human-readable description of the item. The <a>user agent</a> may
           display this to the user.
+          <aside class="note" title="Internationalization of the label">
+            <p>
+              The language and direction of the {{PaymentItem/label}} may often
+              be determined from information inherited from the document.
+              However, this approach may not suffice for some use cases. The
+              working group intends to fix this in a future version by aligning
+              with general approaches for the Web that are in development.
+            </p>
+          </aside>
         </dd>
         <dt>
           <dfn>amount</dfn> member
@@ -1968,6 +1973,16 @@ <h3>
               general overview of validation issues, or it can be passed in
               combination with other members of the {{PaymentValidationErrors}}
               dictionary.
+              <aside class="note" title="Internationalization of the error">
+                <p>
+                  The language and direction of the
+                  {{PaymentValidationErrors/error}} may often be determined
+                  from information inherited from the document. However, this
+                  approach may not suffice for some use cases. The working
+                  group intends to fix this in a future version by aligning
+                  with general approaches for the Web that are in development.
+                </p>
+              </aside>
             </dd>
             <dt>
               <dfn>paymentMethod</dfn> member
