advocacy
Advocacy
A lot can be done to help advocate the use of microformats. Often, simply by taking an existing site, and adding the suggested microformatting to a few of its pages as examples is all that is necessary to help the developers of the site add the microformats to the site itself. Applications, such as browsers, could also use some guidance on how to best support microformats.
Sometimes advocacy requires comparison and analysis of alternative technologies or approaches. As Mike Schinkel pointed out, we need good answers to comments like "No, we're going to use XYZ instead...".
The goal for this page is to include pointers for how to advocate microformats on new sites and on existing sites that are considering or using alternative approaches, as well as applications that can benefit from supporting microformats.
For general resources for marketing microformats, see spread-microformats.
Adding Microformats to Existing Sites
Add sites here that you think would benefit from the addition of microformats. For now they are grouped by the microformat which would primarily benefit the site. Feel free to take a look at some of the sites on this list, document sample pages to be microformatted, add microformats to them, and then add the before/after of the key sections of mark-up to another wiki page for that site.
Successes are also noted; the most recent are flagged as Success!.
If your successes resulted from emails that you sent to site owners/developers, please consider sharing your successful advocacy emails on the advocacy-email-samples page, and along with each email sample, list the sites which responded positively to your email. This way others in the community can learn from your success and hopefully use your email samples to contact additional sites and get them to adopt microformats.
hCard
Adding hCard to these sites would make them quite handy for their users and for being indexed:
Online Profiles
Nearly every website that has a login has a page representing the public profile of the user that other users can see and interact with. Many such sites already support hCard (e.g. ClaimID.com, Flickr.com, Technorati.com, Zooomr.com). Here are some that I think would benefit from the addition of hCard to their profile / user pages. Feel free to add more such sites that have a social network profile-like component and I'll see what I can do. Tantek 17:44, 13 Dec 2006 (PST)
- JPG magazine - have sent email to their web developer with sample marked up member profile with hCard and xfn rel="me". Tantek 23:48, 21 Feb 2007 (PST)
- Twitter.com - working on it Tantek 17:44, 13 Dec 2006 (PST)
- Consumating.com - working on it Tantek 17:44, 13 Dec 2006 (PST)
- Wikimedia - including this site, Wikipedia (See WikiProject Microformats), Wikitravel, etc.
- It would be nice if [[User:YOURNAME]] links generated proper (mini)hCards. (per SteveIvy; moved from 'to-do')
- Alexa.com has online profiles for domains with contact information. Would be great if they could add hCard to those. 2007-04-18 User:Tantek requested of User:BenWest e.g.:
- SunlightLabs API provides profiles for US Congresspeople. Their megatable could easily be marked up with hCard, and their APIs could return hCards and hCard fields.
- Tantek 12:30, 20 Apr 2007 (PDT) contacted them and requested that they add hCard to megatable, consider a GethCard API method, and potentially a GethResume API method for each person.
- Success! CarlAnderson 26 Apr 2007: http://sunlightlabs.com/api does now have a people.getHCard.php API method to get an hCard for every member of congress. See the documentation at http://sunlightlabs.com/api/people.getHCard.php. An example call: http://api.sunlightlabs.com/people.getHCard.php?id=fakeopenID1
- Success! CarlAnderson 30 Apr 2007: I created a page of hCards for every member of congress: http://sunlightlabs.com/api/hcards/index.php
Online Venues
There are many sites that offer pages that represent organizations and venues that could benefit from being marked up with hCard. Yahoo Local venues are marked up with hCards for example. Here are some more sites that have venues that would benefit from hCard markup.
- Dodgeball venues.
- Yelp.com
Wikpedia hCard
- Infobox Templates for people to add hCard to their generated markup
- Infobox_Biography
- Infobox_actor which should result in actor pages, e.g. Humphrey Bogart's page, being properly hCarded.
- Addressable buildings e.g. The Old Crown, Birmingham
- Tourist attractions, e.g. Cadbury World
- Companies, e.g. Tesco (note headquarters address in infobox)
- Motorway service stations, e.g. Watford Gap
- Railway Stations, e.g. Perry Barr
- etc.
- See also WikiProject Microformats Andy Mabbett 13:10, 28 Jan 2007 (PST)
- See also discussion of Wikipedia's Persondata, which aligns very closely with hCard, but has additional date and place of birth & death fields. Andy Mabbett 13:23, 28 Mar 2007 (PDT)
Telephone Directory Listings
Telephone Directory Listings could usefully apply hCard to their results pages. Andy Mabbett 03:10, 13 Nov 2006 (PST)
e.g. (please add other examples!):
- BT
- Requested via BT feedback form, 2006-11-13 Andy Mabbett
- BT confirm that they will consider this at their next re-build. 2006-12 Andy Mabbett
- 118118.com
- Requested via e-mail, 2006-11-13. Andy Mabbett
- 192.com
- Requested via 192.com feedback form, 2007-03-07 Andy Mabbett
- SkypeFind
- Requested via Skype feedback form, 2007-03-16 Andy Mabbett
- White Pages (USA/ Canada)
- White Pages (Australia)
- Stitchboard (USA)]
- Yahoo! People Search (USA)
- Lycos People Search (USA)
- BSNL (India)
Postal (ZIP) code Finders
Postal code Finders could usefully apply hCard to their results pages. Andy Mabbett 12:09, 13 Nov 2006 (PST)
e.g. (please add other examples!):
- Royal Mail (UK)
- Requested via Royal Mail feedback form, 2006-11-13 Andy Mabbett
- Acknowledged 2006-11-30. Andy Mabbett
Government hCard
UK Gov. hCard
- Parliament: Alphabetical List of Members of Parliament (see also other lists of MPs and Lords). Andy Mabbett
Europe Gov. hCard
- e.g. UK MEPs
Organization Contacts
Many companies and organizations have about or contact pages that could benefit from being marked up with hCard. Technorati's contact page for example is both marked up with hCard and has a convenient "Add to Address Book" hCard to vCard converter link. The following company sites could benefit from similar markup (and, until user agents support hCards natively, "Add to Address Book" links). Tantek 17:44, 13 Dec 2006 (PST)
- Adobe
- Adobe offices
- Requested using contact form, 2006-12-14. Andy Mabbett
- Adobe offices
- Google
- Contacts, e.g.
- Google.com contact page
- Requested by asking Google Employee KevinMarks via instant messaging to add hCard to that page along with a "Add to Address Book" link Tantek 11:32, 10 Apr 2007 (PDT) and RyanKing in IRC
- Google UK, etc.
- Google.com contact page
- Contacts, e.g.
- Mozilla
- Opera
- People, e.g. Håkon Wium Lie; could also be hResume
- W3C
- W3C contact
- W3C Staff listing and individual pages, e.g. Tim Berners-Lee
- Requested by e-mail. Andy Mabbett
Individual hCards
Getting these sites to at least add hCard to their home page or contact info page and then ping Pingerati would be an excellent start with getting them some experience with microformats and thinking about adding microformats to other places in their sites that make sense:
Other hCard
- Internet Movie Database (IMDb) for people (real, not characters), e.g. Humphrey Bogart. Andy Mabbett 02:49, 13 Nov 2006 (PST)
- Can't find contact info! Andy Mabbett
- Wikitravel
- e.g. Wikitravel - Birmingham
- Wikitravel is about to hugely roll out hCard Mark Jaroski
- See also Wikitravel:Microformats
- e.g. Wikitravel - Birmingham
- WorldCat Identities
- The recently prototyped WorldCat Identities provides pages for 20 million 'identities', mainly authors and people who are the subjects of published titles.
- Requested by feedback form, 2007-03-09 Andy Mabbett
hCalendar
hCalendar could be used on these sites:
W3C track at WWW2006
- DanC offers a 150 point bounty to anybody who takes the W3C track at WWW2006 and adds hCalendar markup and sends it to connolly@w3.org,www-archive@w3.org
Television listings
- A major coup would be to get one of the major players (the BBC, Sky, or PBS, say), to mark up their TV or radio listings with hCalendar - does anyone have contacts in such an organisation? Andy Mabbett 10:53, 21 Oct 2006 (PDT)
- Does anyone have URLs to the TV or radio listings of the major players? Getting those URLs would be the next step, and then doing the markup ourselves would be the next step after that. Tantek 13:02, 21 Oct 2006 (PDT)
e.g. (please add other examples!):
- TV Times (UK)
- Requested by e-mail 2006-11-13 Andy Mabbett
- BBC main listings (e.g. BBC One)
- Requested by BBC Feedback Form 2006-11-13 Andy Mabbett
- "We're currently looking at using the event microformat on the redesigned radio 4 schedule page (and possibly throughout bbc.co.uk/radio4" 2007-01-14 per email.
Government hCalendar
UK Gov. hCalendar
- E-petitions (in draft, and asking for suggested improvements}
- Requested by e-mail, 2006-12-01 Andy Mabbett 11:47, 1 Dec 2006 (PST)
- reply: "I've added it to our list of ideas." 2006-12-04 Andy Mabbett 11:07, 4 Dec 2006 (PST)
- Requested by e-mail, 2006-12-01 Andy Mabbett 11:47, 1 Dec 2006 (PST)
- Scottish Executive Bank Holidays
- Requested by Scottish Executive feedback form, 2006-11-13 Andy Mabbett
Sports Fixtures
e.g. (please add other examples!):
- PremiumTV (UK, Soccer, has a page for each team)
- Aston Villa
- West Bromwich Albion
- Requested by e-mail, 2006-11-13 Andy Mabbett
- "webmaster@" bounced. Andy Mabbett
- Requested by e-mail, 2006-11-13 Andy Mabbett
Concert/ Theatre Listings
e.g. (please add other examples!):
- Birmingham Alive! (UK)
- Requested in person; now on "to do" list
- iCal share
- Requested by e-mail. 2007-01-14
hReview
hReview could be used on these sites:
Government hReview
UK Gov. hReview
- E-petitions (in draft, and asking for suggested improvements}
- Requested by e-mail, 2006-12-01 Andy Mabbett 11:48, 1 Dec 2006 (PST)
- reply: "I've added it to our list of ideas." 2006-12-04 Andy Mabbett 11:08, 4 Dec 2006 (PST)
- Requested by e-mail, 2006-12-01 Andy Mabbett 11:48, 1 Dec 2006 (PST)
Other hReview
- Internet Movie Database (IMDb) for film reviews, e.g. The Harder They Fall . AndyMabbett 02:49, 13 Nov 2006 (PST)
- Can't find contact info! Andy Mabbett
- Digital Photography Review
- Requested by feedback form, 2007-01-18. Andy Mabbett
- Steve's Digicams
- Requested by e-mail, 2007-01-18. Andy Mabbett
- LibraryThing
- e.g. [1]
hAtom
hAtom could be used on these sites:
Government hAtom
UK Gov. hAtom
- E-petitions (in draft, and asking for suggested improvements}
- Requested by e-mail, 2006-12-01 Andy Mabbett 11:49, 1 Dec 2006 (PST)
- reply: "I've added it to our list of ideas." 2006-12-04 Andy Mabbett 11:07, 4 Dec 2006 (PST)
- Requested by e-mail, 2006-12-01 Andy Mabbett 11:49, 1 Dec 2006 (PST)
Other hAtom
- TV Listings (see hCalendar, above)
- IRC logs
- E-mailed. Andy Mabbett 10:29, 5 Dec 2006 (PST)
- hatom can be used to markup log files. Basically log information is a feed of events. For more details, see the logging technique discussed in on microformats-discuss.
Geo
Adding "Geo" markup to these sites would make them even more useful:
- WikiGPS
- Under development; notified of Geo microformat 2007-03-23
- Collections of waypoints
- See also geo-waypoint-examples
- Upcoming
- Some events, e.g. Multipack February 2007 are tagged thus:
geo:lat=52.4784
,geo:lon=-1.9096
. This could be rendered as a geo microformat. Andy Mabbett - Requested on (now defunct) Upcoming wiki 2007-01-14
- Repeated on new suggestion board. 2007-03-30. Please vote for this suggestion Andy Mabbett
- Some events, e.g. Multipack February 2007 are tagged thus:
- U.S. Gazetteer e.g. [2]
- World Gazetteer e.g. [3]
- Requested by e-mail, 2007-01-20 Andy Mabbett
- GENUKI Gazetteer (UK & Ireland) e.g. [4]
- Requested via feedback form, 2007-01-20 Andy Mabbett
- The Degree Confluence Project
- Requested by e-mail, 2007-03-26 Andy Mabbett
- WikiMapia
- Requested by e-mail, 2007-03-27 Andy Mabbett
- Replied to say they're looking into it. 2007-03-29
- Jeeep.com
- Requested by e-mail, 2007-03-27 Andy Mabbett
- Advertised address bouncing, 2007-03-27
- Flagr
- Using, but not (yet) displaying, coordinates
- Requested by e-mail, 2007-03-30; also suggested they display their coordinates, and mark them up as tags Andy Mabbett
- Replied same day to say they will "talk it over internally"
- Various Geocache listing sites
Adr
Adding "Adr" markup to these sites would make them even more useful:
- Various postcode <--> address lookup sites
- e.g. Royal Mail (UK) - enter a valid postcode (e.g. "B13 9PW").
rel-tag
Google as rel-tag namespace
A Google search for 'sparrow' resolves to http://www.google.com/search?&q=sparrow, if not the unwieldy http://www.google.com/search?hs=TUz&hl=en&lr=&client=firefox-a&rls=org.mozilla%3Aen-GB%3Aofficial&q=sparrow&btnG=Search - likewise http://www.google.com/search?&q=%22black+redstart%22 for ' "black redstart" '. If Google can be persuaded to also accept, say, http://www.google.com/search/sparrow and http://www.google.com/search/black_redstart as being equivalent (and assuming that the latter term searches for ' "black redstart" ', with the quote marks), then Google would become a namespace for rel-tag. Andy Mabbett 00:15, 29 Nov 2006 (PST)
VoteLinks
- Ma.gnolia's link rating system
- Requested: Feature Suggestions on wiki.ma.gnolia.com
Various
- eBay (.com and localised versions)
- hCard - Buyer and seller address details.
- hCalendar - Auction end date/times.
- hReview - Feedback.
- hAtom - Recent purchases/ won/ lost/ watching etc.
- Requested by feedback form, 2006-12-05. Andy Mabbett
- eBay response of 2006-12-08
IT News sites
There is obviously a great deal of publicity to be gained, by having microformats used on sites about IT developments, which are likely to be read by people in a position to have microformats used, and microformat tools implemented, in their organisations. Please add to this list!
- The Register (UK)
- Requested by e-mail, 2006-12-14. Andy Mabbett
- Ziff-Davis media sites, e.g:
- Microsoft Watch
- Linux Watch
- Extreme Tech
- Web Buyer's Guide
- Requested at corporate level, 2006-12-14. Andy Mabbett
- .Net magazine (UK) (issue dated December 2006, has tutorial on microformats, by Rachel Andrew)
- Requested by e-mail, 2006-12-14. Andy Mabbett
- ...
Other high-profile IT sites
- Jakob Nielsen's 'Use It' and his Nielsen Norman Group
- Requested by e-mail, 2007-01-06. Andy Mabbett
- AtMedia2007
- Requested via feedback form, 2007-01-18. Andy Mabbett
- Are using hCard, but will not use hCalendar, saying: "There are aspects of hCalendar that we are not happy using in this situation [...] It surrounds the use of the abbr element, particularly surrounding times in a table cell (the schedule will be slotted into a table once it is ready)." 2007-01-20. Andy Mabbett
- ...
Science + Technology
- Eurekalert
- Requested via e-mail, 2007-01-20. Andy Mabbett
Miscellany
- WikiOutdoors
- Could use hCard, Geo, and others
- Requested, 2007-03-14
- Considering Andy Mabbett 04:17, 15 Mar 2007 (PDT)
Adding Microformats to Applications
User-agents (browsers, etc.) should support microformats natively. For instance, a user should not need to use a third party application or web service to add address details or events from a microformat-using web page to their address book or calendar programme.
Browsers
In addition to the following, third-party developers should be encouraged to make their relevant browser add-ons microforamt aware; or to create new add-ons with microformat capabilities.
Firefox
Firefox developments
- Mozilla are "brainstorming" developments for Firefox 3.0 and beyond, and have a page on microformat handling at http://wiki.mozilla.org/Firefox/Feature_Brainstorming:Microformat_Handling
ReminderFox
- The makers of the ReminderFox extension have put hCalendar support on their ReminderFox "to do" list.
LinkAlert
- The LinkAlert extension could signal when a link is marked as a tag (likewise for other "rel" attributes). Andy Mabbett
- Requested by e-mail 2006-12-29. Andy Mabbett
- Response 2007-01-07: "Thank you for your feedback, I will consider adding [...] rel in a future update."
Opera
- First reference to "microformats" in the Opera forums. 2006-12-13 Andy Mabbett
- Opera Mini (and other browsers on telephones) could especially benefit from recognising the "tel" attributes of hCard, and allowing users to dial numbers found on-line.
- Proposed on forum 2006-12-13 Andy Mabbett
Screenreaders
- Screenreaders (e.g Jaws) could recognise telephone number components of hCards, to differentiate them from other strings of digits. Andy Mabbett 13:02, 9 Dec 2006 (PST)
- Additional to this, I believe that screen reader users would benefit from being able to recognise any of the microformats. For example, there is value in being verbally notified that a page contains "1 contact and 3 events", or being able to seek out rel attributes with help values. Frances Berriman
Publishing Platforms
Blogger
- Chris Messina is advocating more support in Blogger
Drupal
- There's a Drupal group for discussing/advocating/implementing microformats in Drupal
MediaWiki=
- MediaWiki
- See above references to Wikipedia, which runs on MediaWiki (as does this wiki)
Plone
- Plone is an Open Source Content Management System (Plone on Wikipedia).
- See this 2005 Plone user comment
- Plone feature request for rel-tag
- Plone feature request for microformats, submitted 2007-01-06 Andy Mabbett
Semantic MediaWiki=
- [5]
- A semantic version of MediaWiki
Adding Microformats to Web Services
30Boxes
- 30Boxes could accept a URL, parse the page for hCalendar microformats, then present a list to the user. These could be selected (via check-boxes) and uploaded. Andy Mabbett 13:41, 14 Jan 2007 (PST)
ClearForest
- ClearForest Semantic Web Services - uses natural language processing tools to recognise people, organisations, places, events and CVs (resumes) in web pages. Would benefit from recognising hCard, hResume, hCalendar, Geo, Adr, etc. Could also use them in its output. Andy Mabbett 05:09, 6 Dec 2006 (PST)
ma.gnolia
Upcoming
- Upcoming could accept a URL, parse the page for hCalendar microformats, then present a list to the user. These could be selected (via check-boxes) and uploaded. Andy Mabbett
Successes
hCard Successes
- Details of hCard should be added to the Internet Mail Consortium's vCard page
- Requested by e-mail, 2006-11-24 Andy Mabbett
- Success achieved 2006-11-25. Andy Mabbett
- W3C
- Success! W3C webmaster Jean-Guilhem Rouel now has an hCard. Andy Mabbett 15:41, 4 Apr 2007 (PDT)
- Success!Wikipedia-EN - starting to roll-out
- UK Railway station template, e.g. Birmingham New Street station (includes Geo)
hCalendar Successes
- Details of hCalendar should be added to the Internet Mail Consortium's vCalendar page
- Requested by e-mail, 2006-11-24 Andy Mabbett
- Success achieved 2006-11-27. Andy Mabbett
- Radio Times (BBC, UK)
- Requested by e-mail Andy Mabbett
- Success! 2007-03
hReview successes
- The Birder's Library
- Requested; confirmed under development, 2006-12-18.
- Success e.g. Audubon VideoGuide to 505 Birds of North America. Apparently from 2007-01-18 Andy Mabbett
Geo Successes
- Wikitravel
- All articles on places, e.g. Wikitravel guide to Birmingham, England
- See also Wikitravel:Microformats
- Success! achieved 2006-12-13, per [6] see, for example, Wikitravel guide to Birmingham, England Andy Mabbett
- POI66
- Requested by e-mail, 2007-03-23 Andy Mabbett
- Success! - over 58,500 waypoints geo-formatted, in under 4 hours from initial contact!
- Geograph British Isles
- Requested by feedback form, 2007-03-26 Andy Mabbett
- Success! - over 370,000 examples, within 30 minutes of request being submitted!
- AddressFix
- Requested via feedback form, 2007-01-26 Andy Mabbett
- Success! - valid postal addresses/ places converted, within one day of request being submitted.
- Wikipedia
- Success! Wikipedia-EN
- Articles on places, e.g. Wikipedia - Great Barr (roll-out ongoing) 2007-03
- All map link pages linked to from the same, e.g. maps for Wikipedia-EN article on Great Barr 2007-03
- See also WikiProject Microformats
- Success! Wikipedia-DE
- All map link pages e.g. maps for Wikipedia-DE article on Birmingham
- Success! Wikipedia-NL
- All map link pages e.g. maps for Wikipedia-NL article on Birmingham
- Success! GIS-Wiki's "hjl_getCoor" now outputs Geo markup, from a Google Maps API.
- Success! Wikipedia-EN
Rejections
hCalendar rejections
- DTI: Bank Holidays (not Scotland)
- Requested by e-mail, 2006-11-13 Andy Mabbett
- Response: "At the moment we have no plans to use hCalendar or hCard coding due to unresolved concerns about accessibility issues (especially text-to-speech readers), however, we thank you for your suggestion."
- Request for clarification of concerns unanswered.
- Requested by e-mail, 2006-11-13 Andy Mabbett
Geo rejections
- geocaching.com
- Requested via feedback form, 2007-01-27 Andy Mabbett
- "The true benefit of this appears to be allowing sharing between sites [this] is something that GC specifically guards against so would be a major detriment. And most importantly when discussing a site or piece of software that is running smoothly, if it ain't broke, don't fix it. There just does not seem to be a benefit to GC's current plans." 2007-04-02
Comparisons With Alternative Approaches
CalDAV
The CalDAV protocol should not be considered an 'alternative' approach as the two are not mutually exclusive. For more information, see:
Apple Support Tickets
- Calendar Server hCalendar input/output: http://trac.macosforge.org/projects/calendarserver/ticket/19
- Wiki Server hCalendar output (internal RADAR ticket [rdar://5180875/])
Mailing List Threads
- Microformats vs. CalDAV? October 2006
Microsoft Exchange Server
Exchnage Server info to be added.