From 8f9c82d5886f030a73e3f8172e31b942323078e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Thu, 17 May 2018 15:42:47 +1000 Subject: [PATCH] editorial cleanup --- index.html | 89 ++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 60 insertions(+), 29 deletions(-) diff --git a/index.html b/index.html index 517fc0fc..c3699d78 100644 --- a/index.html +++ b/index.html @@ -1810,7 +1810,7 @@

Represents validation errors with the shipping address that is - associated with the event + associated with the event target.
@@ -2097,7 +2097,7 @@

Physical addresses

- A physical address is composed of the following concepts. + A physical address is composed of the following parts.

@@ -2783,96 +2783,127 @@

};

- The AddressErrorFields dictionary's members represent + The members of the AddressErrorFields dictionary represent validation errors with specific parts of a physical address. - Each dictionary member has a dual function: firstly, it denotes there - is a validation error the merchant would like the end user to - correct. Secondly, it provides the merchant with the opportunity to - describe to the end user what is wrong with a particular value (and - possibly how to correct the validation error). As such, the user - agent MAY present these validation errors to the end user. However, a - user agent MAY ignore dictionary members for validation errors that - the end user can't directly correct. + Each dictionary member has a dual function: firstly, it denotes that + a particular part of an address is suffering from a validation error. + Secondly, the string value allows the developer to describe the + validation error (and possibly how the end user can fix the error).

- Merchants need to be aware that users might not have control over - certain parts of an address. As such, they need to be mindful to not - to ask the user to fix things they might not have control over (e.g., - regionCodeError and languageCodeError). + Developers need to be aware that users might not have the ability to + fix certain parts of an address. As such, they need to be mindful to + not to ask the user to fix things they might not have control over + (e.g., languageCodeError).

addressLineError member
- The address line has a validation error. + Denotes that the address line has a validation error. In the + user agent's UI, this corresponds to input field that provided the + PaymentAddress's addressLine attribute's value.
cityError member
- The city has a validation error. + Denotes that the city has a validation error. In the user + agent's UI, this corresponds to input field that provided the + PaymentAddress's city + attribute's value.
countryError member
- The country has a validation error. + Denotes that the country has a validation error. In the user + agent's UI, this corresponds to input field that provided the + PaymentAddress's country attribute's value.
dependentLocalityError member
- The dependent locality has a validation error. + Denotes that the dependent locality has a validation error. + In the user agent's UI, this corresponds to input field that + provided the PaymentAddress's dependentLocality attribute's value.
languageCodeError member
- The language code has a validation error. + Denotes that the language code has a validation error. In + the user agent's UI, this corresponds to input field that provided + the PaymentAddress's languageCode attribute's value.
organizationError member
- The organization has a validation error. + Denotes that the organization has a validation error. In the + user agent's UI, this corresponds to input field that provided the + PaymentAddress's organization attribute's value.
phoneError member
- The phone number has a validation error. + Denotes that the phone number has a validation error. In the + user agent's UI, this corresponds to input field that provided the + PaymentAddress's phone + attribute's value.
postalCodeError member
- The postal code has a validation error. + Denotes that the postal code has a validation error. In the + user agent's UI, this corresponds to input field that provided the + PaymentAddress's postalCode attribute's value.
recipientError member
- The recipient has a validation error. + Denotes that the recipient has a validation error. In the + user agent's UI, this corresponds to input field that provided the + PaymentAddress's addressLine attribute's value.
regionError member
- The region has a validation error. + Denotes that the region has a validation error. In the user + agent's UI, this corresponds to input field that provided the + PaymentAddress's region attribute's value.
regionCodeError member
- The region code representation of the region has a - validation error. + Denotes that the region code representation of the region + has a validation error. In the user agent's UI, this corresponds to + input field that provided the PaymentAddress's + regionCode attribute's value.
sortingCodeError member
- The sorting code has a validation error. + The sorting code has a validation error. In the user agent's + UI, this corresponds to input field that provided the + PaymentAddress's sortingCode attribute's value.
@@ -4093,7 +4124,7 @@

Further, if the shippingAddressErrors - member is present, the user agent MAY display an error + member is present, the user agent SHOULD display an error specifically for each erroneous field of the shipping address. This is done by matching each present member of the AddressErrorFields to a corresponding input