advocacy: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(moved a few hCard successes to section at end, details for dodgeball microformats needs)
Line 22: Line 22:
==== Online Profiles ====
==== 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 [[hcard-implementations|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. [[User:Tantek|Tantek]] 17:44, 13 Dec 2006 (PST)
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 [[hcard-implementations|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. [[User:Tantek|Tantek]] 17:44, 13 Dec 2006 (PST)
* [http://jpgmag.com/ JPG magazine] - have sent email to their web developer with sample marked up member profile with [[hcard|hCard]] and [[xfn]] [[rel-me|rel="me"]]. [[User:Tantek|Tantek]] 23:48, 21 Feb 2007 (PST)
* Twitter.com - working on it [[User:Tantek|Tantek]] 17:44, 13 Dec 2006 (PST)
* Consumating.com - working on it [[User:Tantek|Tantek]] 17:44, 13 Dec 2006 (PST)
* Wikimedia - including this site, Wikipedia (See [http://en.wikipedia.org/wiki/Wikipedia:WikiProject_Microformats WikiProject Microformats]), Wikitravel, etc.
* Wikimedia - including this site, Wikipedia (See [http://en.wikipedia.org/wiki/Wikipedia:WikiProject_Microformats WikiProject Microformats]), Wikitravel, etc.
**It would be nice if <nowiki>[[User:YOURNAME]]</nowiki> links generated proper (mini)hCards. ([http://microformats.org/wiki?title=to-do&diff=12177&oldid=12173#Lazyweb per SteveIvy]; moved from 'to-do')
**It would be nice if <nowiki>[[User:YOURNAME]]</nowiki> links generated proper (mini)hCards. ([http://microformats.org/wiki?title=to-do&diff=12177&oldid=12173#Lazyweb per SteveIvy]; moved from 'to-do')
Line 30: Line 27:
** http://www.alexa.com/data/details?url=alexa.com/
** http://www.alexa.com/data/details?url=alexa.com/
** http://www.alexa.com/data/details?url=w3.org/
** http://www.alexa.com/data/details?url=w3.org/
* [http://sunlightlabs.com/api/ SunlightLabs API] provides profiles for US Congresspeople.  Their [http://sunlightlabs.com/api/masterref/megatable.php megatable] could easily be marked up with hCard, and their APIs could return hCards and hCard fields.
* [http://dodgeball.com/ Dodgeball] profiles and venues need [[hcard|hCard]] for people and organizations
** [[User:Tantek|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.
** [http://www.dodgeball.com/user?uid=30209 a profile]
** {{SuccessMarker}} [[User:CarlAnderson|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
** [http://www.dodgeball.com/venue?vid=23551 a venue] - could also use [[hreview|hReview]] for the user reviews listed there for the venue
** {{SuccessMarker}} [[User:CarlAnderson|CarlAnderson]] 30 Apr 2007: I created a page of hCards for every member of congress: http://sunlightlabs.com/api/hcards/index.php
 
==== Online Venues ====
==== Online Venues ====
There are many sites that offer pages that represent organizations and venues that could benefit from being marked up with hCard. [http://local.yahoo.com/ Yahoo Local] venues are marked up with hCards for example. Here are some more sites that have venues that would benefit from hCard markup.
There are many sites that offer pages that represent organizations and venues that could benefit from being marked up with hCard. [http://local.yahoo.com/ Yahoo Local] venues are marked up with hCards for example. Here are some more sites that have venues that would benefit from hCard markup.
* [http://dodgeball.com/ Dodgeball] venues.
* Yelp.com
* Yelp.com


Line 368: Line 362:
*{{SuccessMarker}}Wikipedia-EN - starting to roll-out
*{{SuccessMarker}}Wikipedia-EN - starting to roll-out
**UK Railway station template, e.g. [http://en.wikipedia.org/wiki/Birmingham_New_Street Birmingham New Street station] (includes Geo)
**UK Railway station template, e.g. [http://en.wikipedia.org/wiki/Birmingham_New_Street Birmingham New Street station] (includes Geo)
* [http://jpgmag.com/ JPG magazine] - have sent email to their web developer with sample marked up member profile with [[hcard|hCard]] and [[xfn]] [[rel-me|rel="me"]]. [[User:Tantek|Tantek]] 23:48, 21 Feb 2007 (PST)
** {{SuccessMarker}} [[hcard|hCard]]+[[xfn]] [[rel-me|rel="me"]] support as of March 2007.
* Twitter.com - working on it [[User:Tantek|Tantek]] 17:44, 13 Dec 2006 (PST). 
** {{SuccessMarker}} Completed [[hcard|hCard]]+[[xfn]]+[[hatom|hAtom]] support last week with help from Chris Messina. [[User:Tantek|Tantek]] 12:01, 16 May 2007 (PDT)
* Consumating.com - working on it [[User:Tantek|Tantek]] 17:44, 13 Dec 2006 (PST)
** {{SuccessMarker}} [[hcard|hCard]] profiles, [[hcalendar|hCalendar]] events as of March 2007.
* [http://sunlightlabs.com/api/ SunlightLabs API] provides profiles for US Congresspeople.  Their [http://sunlightlabs.com/api/masterref/megatable.php megatable] could easily be marked up with hCard, and their APIs could return hCards and hCard fields.
** [[User:Tantek|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.
** {{SuccessMarker}} [[User:CarlAnderson|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
** {{SuccessMarker}} [[User:CarlAnderson|CarlAnderson]] 30 Apr 2007: I created a page of hCards for every member of congress: http://sunlightlabs.com/api/hcards/index.php


=== hCalendar Successes===
=== hCalendar Successes===

Revision as of 19:01, 16 May 2007

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)

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.

  • Yelp.com

Wikpedia hCard

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!):

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!):

Government hCard

UK Gov. hCard
Europe Gov. hCard

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)

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

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!):

Government hCalendar

UK Gov. hCalendar

Sports Fixtures

e.g. (please add other examples!):

Concert/ Theatre Listings

e.g. (please add other examples!):

Travel Industry

any travel site is based on calender type data! Airlines, Hotels etc. Sure it will be nice to get your reservation confirmation, but what about suppliers "syndicating" their product details that are calendar based? This would allow any other to mash-up supplier offerings. Sorry no examples... but I hope this will stimulate others to add some if the know them or just to make others think about possibilities.


iCal Share

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)

Other hReview

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)

Other hAtom

Geo

Adding "Geo" markup to these sites would make them even more useful:

Adr

Adding "Adr" markup to these sites would make them even more useful:

  • Various postcode <--> address lookup sites

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

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!

Other high-profile IT sites

  • Jakob Nielsen's 'Use It' and his Nielsen Norman Group
  • 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

Miscellany

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
ReminderFox
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

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

Drupal

MediaWiki=

  • MediaWiki
    • See above references to Wikipedia, which runs on MediaWiki (as does this wiki)

Plone

Semantic MediaWiki=

  • [5]
    • A semantic version of MediaWiki

Adding Microformats to Web Services

30Boxes

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

Successes

hCard Successes


hCalendar Successes

hReview successes

Geo Successes

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.

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

Mailing List Threads

Microsoft Exchange Server

Exchnage Server info to be added.

See Also