diff --git a/index.bs b/index.bs index a505955..187a63d 100644 --- a/index.bs +++ b/index.bs @@ -161,29 +161,29 @@ The contact picker task source is a [=task source=]. ## Physical address ## {#infrastructure-physical-address} -A physical address consists of: +A physical address consists of:
-* country, a {{DOMString}} representing the country of the address as an +* country, a {{DOMString}} representing the country of the address as an [[ISO3166-1]] alpha-2 code stored in its canonical uppercase form or the empty string. For example, "JP". -* address line, a [=list=] of {{DOMString}}s, containing the most specific part of the +* address line, a [=list=] of {{DOMString}}s, containing the most specific part of the address. It can include, for example, a street name, a house number, apartment number, a rural delivery route, descriptive instructions, or a post office box number. -* region, a {{DOMString}} representing the top level administrative subdivision of the +* region, a {{DOMString}} representing the top level administrative subdivision of the country. For example, this can be a state, a province, an oblast, or a prefecture. -* city, a {{DOMString}} representing the city/town portion of the address. -* dependent locality, a {{DOMString}} representing the dependent locality or sublocality +* city, a {{DOMString}} representing the city/town portion of the address. +* dependent locality, a {{DOMString}} representing the dependent locality or sublocality within a city. For example, neighborhoods, boroughs, districts, or UK dependent localities. -* postal code, a {{DOMString}} representing the postal code or ZIP code, also known as +* postal code, a {{DOMString}} representing the postal code or ZIP code, also known as PIN code in India. -* sorting code, a {{DOMString}} representing the sorting code system, such as the CEDEX +* sorting code, a {{DOMString}} representing the sorting code system, such as the CEDEX system used in France. -* organization, a {{DOMString}} representing the organization, firm, company, or +* organization, a {{DOMString}} representing the organization, firm, company, or institution at the address. -* recipient, a {{DOMString}} representing the name of the recipient or contact person at +* recipient, a {{DOMString}} representing the name of the recipient or contact person at the address. -* phone number, a {{DOMString}} representing the phone number of the recipient or contact +* phone number, a {{DOMString}} representing the phone number of the recipient or contact person at the address, optionally structured to adhere to [[E.164]].
@@ -193,15 +193,15 @@ A physical address consists of: A user contact consists of:
-* names, a [=list=] of {{DOMString}}s, each [=list/item=] representing a unique name +* names, a [=list=] of {{DOMString}}s, each [=list/item=] representing a unique name corresponding to the user. -* emails, a [=list=] of {{DOMString}}s, each [=list/item=] representing a unique - [=valid e-mail address=] of the user. -* numbers, a [=list=] of {{DOMString}}s, each [=list/item=] representing a unique phone +* emails, a [=list=] of {{DOMString}}s, each [=list/item=] representing a unique + [=valid email address=] of the user. +* numbers, a [=list=] of {{DOMString}}s, each [=list/item=] representing a unique phone number of the user. -* addresses, a [=list=] of {{ContactAddress}}es, each [=list/item=] representing a +* addresses, a [=list=] of {{ContactAddress}}es, each [=list/item=] representing a unique [=physical address=] of the user. -* icons, a [=list=] of {{Blob}}s, each [=list/item=] representing a unique image of the +* icons, a [=list=] of {{Blob}}s, each [=list/item=] representing a unique image of the user. NOTE: An icon {{Blob}}'s {{Blob/type}} is an [=image mime type=].