advocacy: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(→‎hAtom: emphasise vote link)
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(300 intermediate revisions by 23 users not shown)
Line 1: Line 1:
<h1>Advocacy</h1>
{{DISPLAYTITLE: 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.
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 [[User:MikeSchinkel|MikeSchinkel]] pointed out, we need good answers to comments like "No, we're going to use XXX instead...".
Sometimes advocacy requires comparison and analysis of alternative technologies or approaches.  As [[User:MikeSchinkel|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.
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.
Line 9: Line 9:
For general resources for marketing microformats, see [[spread-microformats]].
For general resources for marketing microformats, see [[spread-microformats]].


== Adding Microformats to Existing Sites ==
== 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.


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 (so that folks who feel they are good at adding a particular microformat.  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 markup to another wiki page for that site.
Successes are also noted; the most recent are flagged as {{SuccessMarker}}.


=== hCard ===
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.


Details of hCard should be added to the [http://www.imc.org/pdi/ Internet Mail Consortium's vCard page]
=== organization ===
*Requested by e-mail, 2006-11-24 [[User:AndyMabbett|Andy Mabbett]]
For now this section is organized primarily by microformat, as that's easier for the community to document and keep track of.
*'''Success''' achieved 2006-11-25. [[User:AndyMabbett|Andy Mabbett]]


Adding hCard to these sites would make them quite handy for their users and for being indexed:
However, it may be more useful to publishers if we created another section organized by type of site.


====Wikpedia====
E.g.:
*Infobox Templates for people to add [[hcard|hCard]] to their generated markup
* [[education]] - how to add microformats to education sites, especially higher education sites.
** [http://en.wikipedia.org/w/index.php?title=Template:Infobox_Biography&action=edit Infobox_Biography]
* [[social networks]] - how to add microformats to social networks, especially for [[social-network-portability]].
** [http://en.wikipedia.org/w/index.php?title=Template:Infobox_actor&action=edit Infobox_actor] which should result in actor pages, e.g. [http://en.wikipedia.org/wiki/Humphrey_Bogart Humphrey Bogart]'s page, being properly hCarded.
*Addressable buildings e.g. [http://en.wikipedia.org/wiki/The_Old_Crown%2C_Birmingham The Old Crown, Birmingham]
*Tourist attractions, e.g. [http://en.wikipedia.org/wiki/Cadbury_World Cadbury World]
*Companies, e.g. [http://en.wikipedia.org/wiki/Tesco Tesco] (note headquarters address in infobox)
*Motorway service stations, e.g. [http://en.wikipedia.org/wiki/Watford_Gap_service_station Watford Gap]
*Railway Stations, e.g. [http://en.wikipedia.org/wiki/Perry_Barr_railway_station Perry Barr]
*etc.


====Telephone Directory Listings====
etc.
Telephone Directory Listings could usefully apply hCard to their results pages. [[User:AndyMabbett|Andy Mabbett]] 03:10, 13 Nov 2006 (PST)


e.g. (please add other examples!):
== by microformat ==
*[http://www.thephonebook.bt.com/ BT]
<!-- spans with ids for preserving previous heading fragment id references -->
**Requested via [http://tinyurl.com/yhtdjy BT feedback form], 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
* <span id="hCard">[[hcard-advocacy]]</span>
*[http://118118.com 118118.com]
** <span id="Geo">[[geo-advocacy]]</span>
**Requested via e-mail, 2006-11-13. [[User:AndyMabbett|Andy Mabbett]]
** <span id="Adr">[[adr-advocacy]]</span>
* <span id="hCalendar"> [[hcalendar-advocacy]]</span>
* <span id="hReview">[[hreview-advocacy]]</span>
* <span id="hAtom">[[hatom-advocacy]]</span>
* <span id="rel-tag">[[rel-tag-advocacy]]</span>
* <span id="VoteLinks">[[vote-links-advocacy]]</span>
* <span id="XFN">[[xfn-advocacy]]</span>


====Postal (ZIP) code Finders====
=== h-entry ===
Postal code Finders could usefully apply hCard to their results pages. [[User:AndyMabbett|Andy Mabbett]] 12:09, 13 Nov 2006 (PST)
* '''pump.io''' - add h-entry + h-card support to pump.io's web view:
** https://github.com/e14n/pump.io


e.g. (please add other examples!):
== browsers ==
*[http://pol.royalmail.com/dda/txt/pf.asp Royal Mail] (UK)
[[Browser]] support of microformats, both built-in, and via plug-ins and extension helps users make better use of the numerous existing sites that have microformats support, as well as encourage sites and site developers to add microformats support.
**Requested via [http://tinyurl.com/ya4hzu Royal Mail feedback form], 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]


====Government====
See [[browser-advocacy]].
=====UK=====
* Parliament: [http://www.parliament.uk/directories/hciolists/alms.cfm Alphabetical List of Members of Parliament] (see also [http://www.parliament.uk/directories/directories.cfm other lists of MPs and Lords]). [[User:AndyMabbett|Andy Mabbett]]


=====Europe=====
== publishing tools ==
* e.g. [http://www.europarl.org.uk/uk_meps/westmidlands.asp UK MEPs]
Getting publishing tools adopt microformats will perhaps have the biggest impact on expanding the adoption and support of microformats.
See [[cms]] for current publishing platform support.
* [[cms-advocacy]]
* [[blogging-tools-advocacy]]
Others:
* postlets.com - which crossposs to craigslist.com and other classifieds services. If they generated span+a microformats (which apparently survive posting into Craigstlist posting), the posters could get postings in hCard without any additional work.
** check oodle.com also.


====Other====
== web agencies ==
* [http://dodgeball.com/ Dodgeball] venues
More and more [[web-agencies]] are supporting microformats both on their own sites and on sites they build.  
* [http://www.imdb.com/ Internet Movie Database] (IMDb) for people (real, not characters), e.g. [http://www.imdb.com/name/nm0000007/ Humphrey Bogart]. [[User:AndyMabbett|Andy Mabbett]] 02:49, 13 Nov 2006 (PST)
**Can't find contact info! [[User:AndyMabbett|Andy Mabbett]]
* [http://www.w3.org/People/all W3C Staff listing] and individual pages, e.g. [http://www.w3.org/People/Berners-Lee/ Tim Berners-Lee]
**Requested by e-mail. [[User:AndyMabbett|Andy Mabbett]]
*Google contacts
**e.g. [http://www.google.com/intl/en/contact/index.html Google USA], [http://www.google.co.uk/intl/en/contact/index.html Google UK], etc.
*Wikitravel
**e.g. [http://wikitravel.org/en/Birmingham_%28England%29 Wikitravel - Birmingham]
***[http://microformats.org/wiki?title=User_talk:MarkJaroski&curid=2699&diff=0&oldid=10663&rcid=19955 Wikitravel is about to hugely roll out hCard] Mark Jaroski
***See also [http://wikitravel.org/en/Wikitravel:Microformats Wikitravel:Microformats]
* ...


=== hCalendar ===
Getting more web design, development, etc. agencies and related efforts to adopt microformats also has the indirect benefit of them supporting microformats in the sites they build and develop.


Details of hCalendar should be added to the [http://www.imc.org/pdi/ Internet Mail Consortium's vCalendar page]
If you are a strong and vocal supporter of microformats in your work, please feel free to add yourself to the
*Requested by e-mail, 2006-11-24 [[User:AndyMabbett|Andy Mabbett]]
* [[web-agencies]] page


==== W3C track at WWW2006 ====
== online tutorials ==
* DanC offers a 150 point bounty to anybody who takes [http://www.w3.org/2006/05/w3c-track the W3C track at WWW2006] and adds hCalendar markup and sends it to connolly@w3.org,www-archive@w3.org
Add [[microformats2]] to topical online tutorials, especially if they already have classic microformats examples that can be updated.


====Television listings====
* https://stackoverflow.com/questions/5125856/should-i-use-meta-name-author-content-your-name-or-link-rel-author-hr
*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? [[User:AndyMabbett|Andy Mabbett]] 10:53, 21 Oct 2006 (PDT)
** has [[hCard]] example that should be updated to [[h-card]]
**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. [[User:Tantek|Tantek]] 13:02, 21 Oct 2006 (PDT)


e.g. (please add other examples!):
== multiple microformats ==
*[http://www.radiotimes.com/ Radio Times] (BBC, UK)
<span id="Various">In general add such sites to the page for the primary microformat which would benefit from the sites' support. See above.</span>
** Requested by e-mail [[User:AndyMabbett|Andy Mabbett]]
*[http://www.tvtimes.co.uk/ TV Times] (UK)
** Requested by e-mail 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
*BBC main listings (e.g. [http://www.bbc.co.uk/bbcone/listings/index.shtml?service_id=4223 BBC One])
** Requested by [http://www.bbc.co.uk/feedback/bbci_comment.shtml BBC Feedback Form] 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]


====Government====
== successes ==
=====UK=====
=== Magnolia ===
*[http://www.dti.gov.uk/employment/bank-public-holidays/index.html DTI: Bank Holidays] (not Scotland)
[http://ma.gnolia.com ma.gnolia] supports many microformats. These should all be incorporated into the [[examples-in-the-wild]] pages for each specific microformat.
** Requested by e-mail, 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
* [http://wiki.ma.gnolia.com/Microformat_Feature_Requests Microformat Feature Requests on ma.gnolia wiki]
***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."
* {{SuccessMarker}} [http://ma.gnolia.com ma.gnolia] is implementing semantic features and microformats quickly. Here's a screenshot of my ma.gnolia page, and the Firefox [https://addons.mozilla.org/en-US/firefox/addon/4106 Operator extension]'s response to its code. Shiny. :) --[[User:CarlaHufstedler|Carla]] 10:30, 1 Sep 2007 (PDT)<br />
*[http://www.scotland.gov.uk/Publications/2005/01/bankholidays Scottish Executive Bank Holidays]
[http://flickr.com/photos/hauntedpalace/1296152892/ http://farm2.static.flickr.com/1390/1296152892_20108bd860_d.jpg] (click for larger version)
** Requested by [http://www.scotland.gov.uk/About/HaveYourSay/WebsiteFdbck Scottish Executive feedback form], 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
* {{SuccessMarker}} added a [http://wiki.ma.gnolia.com/Category:Microformats microformats category] to the ma.gnolia wiki, with information, and then added it to appropriate pages --[[User:CarlaHufstedler|Carla]] 10:37, 3 Sep 2007 (PDT)


====Sports Fixtures====
=== OpenStreetMap ===
e.g. (please add other examples!):
* I've just added Geo to OpenStreetMap documentation pages - see [http://wiki.openstreetmap.org/index.php/Birmingham Birmingham page on OpenStreetMap] for example. [[User:AndyMabbett|Andy Mabbett]] 02:39, 6 Apr 2007 (PDT)
*PremiumTV (UK, Soccer, has a page for each team)
* [http://www.openstreetmap.org OpenStreetMap] uses the geo microformat on its wiki for place pages (added by [http://wiki.openstreetmap.org/index.php/User:Pigsonthewing Andy Mabbett]) and also on the GPS trace pages and diary entry pages ([http://www.dankarran.com/blog/archives/2007/09/04/pinpoint_your_openstreetmap_diary_entries.php added] by [http://www.dankarran.com Dan Karran]).
**[http://www.avfc.premiumtv.co.uk/page/Fixtures/ Aston Villa]
**[http://www.wba.premiumtv.co.uk/page/Fixtures/ West Bromwich Albion]
*** Requested by e-mail, 2006-11-13 [[User:AndyMabbett|Andy Mabbett]]
****"webmaster@" bounced. [[User:AndyMabbett|Andy Mabbett]]


====Concert/ Theatre Listings====
=== Wikipedia ===
e.g. (please add other examples!):
For successes on Wikipedia, see the list of [http://en.wikipedia.org/wiki/Category:Templates_generating_microformats Wikipedia templates generating microformats].
*[http://www.birmingham-alive.com/ Birmingham Alive!] (UK)
**Requested in person; now on "to do" list


=== hReview ===
See also the individual microformats advocacy pages for specific microformat successes.
* [http://www.imdb.com/ Internet Movie Database] (IMDb) for film reviews, e.g. [http://www.imdb.com/title/tt0049291/ The Harder They Fall ]. [[User:AndyMabbett|AndyMabbett]] 02:49, 13 Nov 2006 (PST)
**Can't find contact info! [[User:AndyMabbett|Andy Mabbett]]


=== hAtom ===
Specifics:
* TV Listings (see hCalendar, above)
*[http://www.mediawiki.org/wiki/MediaWiki *MediaWiki] (Wikipedia and other users, including this 'Wiki') - article histories
**[http://bugzilla.wikimedia.org/show_bug.cgi?id=7913 Bug 7913] raised 2006-11-13. '''[http://bugzilla.wikimedia.org/votes.cgi?action=show_user&bug_id=7913 vote to add hAtom to the change log of media wiki pages]''' [[User:AndyMabbett|Andy Mabbett]]
*[http://rbach.priv.at/Microformats-IRC/2006-11-13 IRC logs]


=== Geo ===
Geo on Wikipedia:
Adding "Geo" markup to these sites would make them even more useful:
*Wikipedia-IT now has Geo on all  [http://it.wikipedia.org/wiki/Speciale:PuntanoQui/Template:Coord pages using the ''coord'' template], e.g. [http://it.wikipedia.org/wiki/Messina Messina]. [[User:AndyMabbett|Andy Mabbett]] 07:05, 26 May 2007 (PDT)
*Wikipedia
*I've added geo to [http://commons.wikimedia.org/wiki/Special:Whatlinkshere/Template:Location_dec_US all images tagged in Wikimedia Commons] using decimal values. Example: [http://commons.wikimedia.org/wiki/Image:Montreal_City_Hall_Jan_2006.jpg Montreal City Hall, Jan 2006]  [[User:AndyMabbett|Andy Mabbett]] 08:54, 12 Apr 2007 (PDT)
**All articles on places, e.g. [http://en.wikipedia.org/wiki/Birmingham Wikipedia - Birmingham] (note co-ordinates already present in infobox)
**Now on pages tagged in D-M-S also.
*Wikitravel
* Wikipedia-NL now has Geo on all its map-links pages, e.g. [http://www.nsesoftware.nl/wiki/maps.asp?params=52_28_47_N_1_53_51_W_type:city_region:GB&src=Birmingham_%28Engeland%29 maps for Wikipedia-NL article on Birmingham]
**All articles on places, e.g. [http://wikitravel.org/en/Birmingham_%28England%29 Wikitravel - Birmingham]
**Called from '''87,724''' article pages as of 2006-04-09; reportedly the sixth most popular website in the Netherlands [http://www.multiscope.nl/organisatie/nieuws/sberichten/nederlandse-wikipedia-groeit-als-kool.html].
**See also [http://wikitravel.org/en/Wikitravel:Microformats Wikitravel:Microformats]
* I recently added Geo to Wikipedia-DE's map link pages  e.g. [http://tools.wikimedia.de/~magnus/geo/geohack.php?language=de&params=52_28_47_N_1_53_51_W_type:city_region:GB maps for Wikipedia-DE article on Birmingham]. [[User:AndyMabbett|Andy Mabbett]] 14:27, 9 Apr 2007 (PDT)


== Adding Microformats to Applications ==
* I've [http://en.wikipedia.org/w/index.php?title=Template%3AGeoTemplate&diff=119003866&oldid=118216477 just added] Geo to Wikipedia's [http://en.wikipedia.org/wiki/Template:GeoTemplate GeoTemplate] which is called by '''many thousands''' of other Wikipedia pages. Example: the coordinates (top right) in [http://en.wikipedia.org/wiki/Great_Barr] link to [http://tools.wikimedia.de/~magnus/geo/geohack.php?params=52.54833_N_1.93212_W_region:GB_source:enwiki-osgb36(SP047945)]; the latter now has a Geo microformat. [[User:AndyMabbett|Andy Mabbett]] 03:38, 30 Mar 2007 (PDT)
 
** [http://tools.wikimedia.de/~kolossos/wp-world/imageworld-art.php Map showing global distribution of Geo-tagged Wikipedia articles].
=== 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===
*[http://reminderfox.mozdev.org/] ReminderFox have hCalendar import on their "to do " list.
 
== Comparisons With Alternative Approaches ==
 
=== CalDAV ===
 
====Brian Suda====
The other great thing about exposing your data as microformats, is that the data becomes Open Data. Will the general public have access to the CalDAV? (probably not) and even if they did, it will probably only serve-up .ics files... what if i don't want ICS? i need to then hack that around to get it into the format that i want... if the data were in the HTML to begin with, then i could EASILY convert that to any format i wanted. Also, sites like http://pingerati.net/ will happily take in hCalendar data and aggregate it, make your data more valuable and easily slurped up by other providers - i don't see that happening as easily with a CalDAV.
 
====Kevin Marks====
With respect to CalDAV: I spoke to the CalDAV chaps at Apple about this, they have hCalendar support as a ticket in their db:
http://trac.macosforge.org/projects/calendarserver/ticket/19


== old ==
These sites have shown no activity for 6 months or more and thus are perhaps not worth the effort.
*<span id="ClearForest">[http://sws.clearforest.com/ ClearForest Semantic Web Services ]</span> - 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.


== See Also ==
== See Also ==

Latest revision as of 16:20, 18 July 2020


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.

organization

For now this section is organized primarily by microformat, as that's easier for the community to document and keep track of.

However, it may be more useful to publishers if we created another section organized by type of site.

E.g.:

etc.

by microformat

h-entry

browsers

Browser support of microformats, both built-in, and via plug-ins and extension helps users make better use of the numerous existing sites that have microformats support, as well as encourage sites and site developers to add microformats support.

See browser-advocacy.

publishing tools

Getting publishing tools adopt microformats will perhaps have the biggest impact on expanding the adoption and support of microformats. See cms for current publishing platform support.

Others:

  • postlets.com - which crossposs to craigslist.com and other classifieds services. If they generated span+a microformats (which apparently survive posting into Craigstlist posting), the posters could get postings in hCard without any additional work.
    • check oodle.com also.

web agencies

More and more web-agencies are supporting microformats both on their own sites and on sites they build.

Getting more web design, development, etc. agencies and related efforts to adopt microformats also has the indirect benefit of them supporting microformats in the sites they build and develop.

If you are a strong and vocal supporter of microformats in your work, please feel free to add yourself to the

online tutorials

Add microformats2 to topical online tutorials, especially if they already have classic microformats examples that can be updated.

multiple microformats

In general add such sites to the page for the primary microformat which would benefit from the sites' support. See above.

successes

Magnolia

ma.gnolia supports many microformats. These should all be incorporated into the examples-in-the-wild pages for each specific microformat.

1296152892_20108bd860_d.jpg (click for larger version)

  • Success! added a microformats category to the ma.gnolia wiki, with information, and then added it to appropriate pages --Carla 10:37, 3 Sep 2007 (PDT)

OpenStreetMap

Wikipedia

For successes on Wikipedia, see the list of Wikipedia templates generating microformats.

See also the individual microformats advocacy pages for specific microformat successes.

Specifics:

Geo on Wikipedia:

old

These sites have shown no activity for 6 months or more and thus are perhaps not worth the effort.

  • 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.

See Also