canmove, Confirmed users
2,887
edits
WebAPI/ContactsAPI: Difference between revisions
Jump to navigation
Jump to search
→FAQ: add Why re-use property names from vCard and hCard
(→FAQ: add more q&a: Why are abbreviations used for adr bday org tel, What is impp) |
(→FAQ: add Why re-use property names from vCard and hCard) |
||
| Line 170: | Line 170: | ||
=== Why are abbreviations used for adr bday org tel === | === Why are abbreviations used for adr bday org tel === | ||
* Why are abbreviations used for the 'adr', 'bday', 'org', and 'tel' properties? | * Why are abbreviations used for the 'adr', 'bday', 'org', and 'tel' properties? | ||
** '''property names re-used literally from vCard/hCard.''' 'adr', 'bday', 'org', and 'tel' are re-used with the same semantics from [[vCard]] and [[hCard]] (which itself is a [http://microformats.org/2010/07/08/microformats-org-at-5-hcards-rich-snippets#billions-hcards well-established part of the web platform]). It is better to re-use names of existing properties rather than re-name them in a good intentioned (but ill-wrought) attempt to "fix" names (for differing opinions/values of "fix"). This is a general design principle borne out of experience with earlier attempts at re-use/re-naming which resulted in unnecessary vocabulary divergence. See '''[http://microformats.org/wiki/minimal-vocabulary#preserve_literal_vocabulary_when_reusing_meaning preserve literal vocabulary when reusing meaning]''' and the | ** '''property names re-used literally from vCard/hCard.''' 'adr', 'bday', 'org', and 'tel' are re-used with the same semantics from [[vCard]] and [[hCard]] (which itself is a [http://microformats.org/2010/07/08/microformats-org-at-5-hcards-rich-snippets#billions-hcards well-established part of the web platform]). It is better to re-use literal names of existing properties rather than re-name them in a good intentioned (but ill-wrought) attempt to "fix" names (for differing opinions/values of "fix"). This is a general design principle borne out of experience with earlier attempts at re-use/re-naming which resulted in unnecessary vocabulary divergence. See '''[http://microformats.org/wiki/minimal-vocabulary#preserve_literal_vocabulary_when_reusing_meaning preserve literal vocabulary when reusing meaning]'''. | ||
=== Why re-use property names from vCard and hCard === | |||
* Why re-use property names from vCard and hCard? | |||
** '''clarity, continuity, interoperability, avoiding divergence'''. Re-using names when re-using semantics from well established existing standards has the advantage of better consistency, clarity, understanding, continuity, interoperability, and perhaps most importantly, avoiding divergence, which is exactly what does happen (and has) when people re-name things, abbreviations or otherwise. See: '''[http://microformats.org/wiki/minimal-vocabulary#avoid_renaming_when_reusing avoid renaming when reusing]''' and note the provided example of the failed/divergent efforts to rename the 'org' property in particular over the years. | |||
=== What is impp === | === What is impp === | ||
* What is impp? | * What is impp? | ||