WebAPI/ContactsAPI: Difference between revisions

Jump to navigation Jump to search
add FAQ section
(add FAQ section)
Line 72: Line 72:
** formal-name (per suggestion from Jonas), like name, but with all "honorable so and so" etc. included as you would formally address or introduce someone. needs examples of publication on the web, and/or device address books that actually include such a field (haven't seen one yet).
** formal-name (per suggestion from Jonas), like name, but with all "honorable so and so" etc. included as you would formally address or introduce someone. needs examples of publication on the web, and/or device address books that actually include such a field (haven't seen one yet).


* could use clarification of why a number of fields are arrays instead of optional DOMString.  e.g. givenName, familyName, and fields of the flattened adr.  Those seem like 0-or-1 cases, not lists.
== FAQ ==
=== Why are givenName familyName arrays instead of optional ===
* could use clarification of why a number of fields are arrays instead of optional DOMString.  e.g. givenName, familyName.  Those seem like 0-or-1 cases, not lists.
** '''In short, i18n.''' Experience with vCard3 and hCard with international content has shown that multiple different languages/cultures have multiple given names and family names, and thus the change was made in [[vCard4]] to make these multivalued. - [[User:Tantek|Tantek]] 10:37, 25 October 2011 (PDT)
=== Why are flattened adr properties arrays instead of optional ===
* could use clarification of why a number of fields are arrays instead of optional DOMString.  e.g. fields of the flattened adr.  Those seem like 0-or-1 cases, not lists.
** '''In short, simplification and i18n.''' The multivalued adr properties are a result of both lack of use / common mis-use of post-office-box and extended-address properties (such data is more often/reliably shoved into multiple lines of street-address) and countries having multiple lines/values for street-address and/or locality/region. - [[User:Tantek|Tantek]] 10:37, 25 October 2011 (PDT)
canmove, Confirmed users
2,887

edits

Navigation menu