to-do: Difference between revisions
AndyMabbett (talk | contribs) m (→wiki gardening: re-order. for clarity) |
(→wiki gardening: trim fixups were completed a while ago!) |
||
(132 intermediate revisions by 26 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{DISPLAYTITLE:To Do}} | ||
__TOC__ | |||
This page is for posting [[microformats]] related shared to do items. If you want to use this page for your microformats related to-do items, create a section with your name on it. The reason we are keeping these all on the same page is to make it easier to tell when people are working on similar things, and to make it more obvious when people help out with other people's tasks. In theory this probably won't scale, but let's first see how it does in practice. :) - [https://tantek.com Tantek] | |||
== site homepage update == | |||
The top level home page (microformats.org) needs updating to be more welcoming to newcomers, and to highlight recent efforts & updates. | |||
== | See subsections here, and search some of the older to-do items in later section for other thoughts on updating the home page (both top level and wiki, e.g. look for "homepage" and "home page" further down on this page. | ||
=== why microformats === | |||
from capjamesg: <blockquote>I’d love to see something like a “why microformats?” section. I know we touch on this a lot on the wiki but I’d love to see a few concise points easily accessible on the home page. Or even a “why microformats?” link in the navigation bar or something.</blockquote> | |||
Perhaps a sidebar box, similar to the current "What are microformats?" section? Feel free to brainstorm here, or create a separate page to brainstorm, | |||
* e.g. '''[[why]]''' | |||
and then link to that as a start. | |||
James has written a draft /why page that could get us started: https://gist.github.com/capjamesg/ee224a4d15b1212d836ca6ba92c96189 | |||
==== specifications ==== | |||
A new /why page should clearly summarize why someone who is looking at our site should consider adding microformats to a page. | |||
We should make sure that the /why page addresses reasons that may be applicable to a broad spectrum of people, from those building personal websites to people who are here to help improve their SEO by using structured data. | |||
=== accessibility === | |||
There are a few contrast errors on the home page which might make the page harder for those who are visually impaired to read. | |||
The main issues are: | |||
* the color of link text | |||
* the orange headings (h2s and h3s) | |||
* the light grey used to denote publication date and author of posts | |||
* the "search blog" bar is missing a label | |||
== link to recent formats == | |||
from capjamesg: <blockquote>I also noticed the home page doesn’t link to h-entry and a few other h- formats. I think it should </blockquote> | |||
Perhaps update the "Microformat specifications" sidebar section with at least h-entry and h-feed, maybe drop rel-license, rel-tag, and XOXO (they’re not that useful on their own)? Thoughts? | |||
* Linking to all relevant specs from the home page will help show that they are active specs. Right now one really has to know what they are looking for to come across the h-entry or h-feed specs. | |||
== more community updates == | |||
from capjamesg: <blockquote>more community updates to share on the home page.</blockquote> | |||
ideas or suggestions? | |||
* capjamesg: a few people write microformats use case studies that shows how they are using them | |||
* capjamesg: how I use microformats for my site, webmention receiver, and other projects | |||
* capjamesg: a digest of some issues that the community is actively discussing on GitHub, perhaps with requests for help | |||
=== Notes === | |||
Having more community updates would convey that there are still many active discussions going on in the microformats community. These discussions often happen in IndieWeb channels so they are less visible to someone who has just visited the microformats.org site for the first time. | |||
== microformats2 updates == | |||
The following pages need to be updated to for microformats2 (typically code, examples, and any specific format advice) | |||
* [[what-are-microformats]] | |||
* [[introduction]] | |||
* [[get-started]] | |||
** This page could potentially be consolidated with http://microformats.org/2014/03/05/getting-started-with-microformats2, currently linked at the top of the page. The [[get-started]] page has an easy to read format while the linked page on getting started with microformats2 is more detailed but less easy to skim. | |||
* [[faq]] | |||
* [[hcard-authoring]] -> [[h-card-authoring]] | |||
* [[hcard-examples]] -> [[h-card-examples]] | |||
* [[advocacy]] | |||
* ... | |||
== wiki gardening == | |||
=== simplify pages === | |||
Review pages, from the [[Main Page]] on down and: | |||
* Simplify/minimize the content in the pages with direct writing, assuming an eager(impatient,positive) reader in the primary reading flow. | |||
* Move (keep) clarifications/details/documentation for edge case people (i.e. deliberate misinterpreters, sarcastic skeptics, pedants etc.) to details further down in a page (or on subpages) rather than in the primary reading flow. | |||
Examples of simplified pages: | |||
* [[Main Page]] - simplified quite a bit (2012-04-02), but could probably use additional simplification | |||
* ... | |||
Pages to simplify: | |||
* [[how-to-play]] (should probably be done by an admin, but left here in case someone wants to try drafting a revision on another page and have an admin review it) | |||
* pages listed in [[stable-pages]] (simplifying these first will help with better translations) | |||
** for specifications, please work with their editor(s) on non-trivial content copy edits. | |||
=== remove broken URLs === | |||
There's lots of links to sites that are now gone (see [https://indiewebcamp.com/site-deaths site-deaths] on IWC for a full list). | |||
It'd be useful if we replaced them where possible with links to archive.org or equivalent. | |||
TODO (mark as done when done): | |||
* [[Upcoming]] | |||
* code.google.com | |||
=== incorporate things expected to break === | |||
==== shortlink spec ==== | |||
The rel=shortlink spec: | |||
* https://code.google.com/p/shortlink/wiki/Specification | |||
is going to die soon as part of Google Code's shutdown. | |||
1. We should copy that spec (along with FAQ for the first few valid questions/comments) to [[rel-shortlink]], moving existing contents there to supplementary pages or purely historical record. | |||
2. Get http://purl.org/net/shortlink to redirect to [[rel-shortlink]] instead. | |||
== more documentation and research == | |||
=== extract from 1989 timbl proposal === | |||
* extra all specific problems and use-cases mentioned in https://www.w3.org/History/1989/proposal.html | |||
* write them up as their own wiki pages, one per specific problem/use-case | |||
* see if they're solvable with modern [[microformats2]] | |||
== microformats specific == | |||
Just some nice things, feel free to do any of these. | Just some nice things, feel free to do any of these. | ||
=== for all microformats === | === for all microformats === | ||
* quick and easy "how to" pages for each microformat. [[get-started]] is a good overall start. | * quick and easy "how to" pages for each microformat. [[get-started]] is a good overall start. | ||
* brief summary statements for each microformat that explain why it matters, what does it accomplish for the publisher. | * brief summary statements for each microformat that explain why it matters, what does it accomplish for the publisher. | ||
* write up [ | * write up [https://microformats.org/discuss/ mailing-list] questions and answers in the appropriate [[faq]] pages. | ||
* validators. See the hReview section below as there has been a request for an hReview validator in particular. See [http://norman.walsh.name/2006/04/13/validatingMicroformats Norman Walsh's blog post "Validating microformats"] for some valuable analysis and validation pseudo-code (prose description), which are useful steps towards building microformat validators. | * validators. See the hReview section below as there has been a request for an hReview validator in particular. See [http://norman.walsh.name/2006/04/13/validatingMicroformats Norman Walsh's blog post "Validating microformats"] for some valuable analysis and validation pseudo-code (prose description), which are useful steps towards building microformat validators. | ||
* Submit definitions of "microformat", and individual examples, to the [http://foldoc.org Free On-line Dictionary of Computing], acording to [http://foldoc.org/editing.html the Free On-line Dictionary of Computing guidelines] | * Submit definitions of "microformat", and individual examples, to the [http://foldoc.org Free On-line Dictionary of Computing], acording to [http://foldoc.org/editing.html the Free On-line Dictionary of Computing guidelines] | ||
* it would be nice to replace the -in-the-wild pages with a form that accepted URL entries that would both register the site and look for valid microformatted content and for those pages with problems, would set them aside in a queue to be reviewed by the community. Having such an interface would likely be more efficient for implementors looking to have their work reviewed, and would also add to a ready-database of microformats in the wild -- which would be a great way to feed pingerati.com. [[User:Chris_Messina Chris Messina]] on 2007 Aug 31. | * it would be nice to replace the -in-the-wild pages with a form that accepted URL entries that would both register the site and look for valid microformatted content and for those pages with problems, would set them aside in a queue to be reviewed by the community. Having such an interface would likely be more efficient for implementors looking to have their work reviewed, and would also add to a ready-database of microformats in the wild -- which would be a great way to feed pingerati.com. [[User:Chris_Messina Chris Messina]] on 2007 Aug 31. | ||
* | * check with the group and then, assuming this is accepted, remove mention of the profile="" attribute from the wiki, since HTML5 removes the need for profiles to be declared | ||
=== hCard === | === hCard === | ||
* microformatted versions of conference pages | * microformatted versions of conference pages | ||
** Wait for confirmation from O'Reilly webmaster on revision of the [http://conferences.oreillynet.com/etel2006/ ETel] [http://conferences.oreillynet.com/pub/w/44/speakers.html speaker's page] with all the speakers marked up with [[hcard|hCard]] and links to "Add hCards to Address Book" etc., similar to the [ | ** Wait for confirmation from O'Reilly webmaster on revision of the [http://conferences.oreillynet.com/etel2006/ ETel] [http://conferences.oreillynet.com/pub/w/44/speakers.html speaker's page] with all the speakers marked up with [[hcard|hCard]] and links to "Add hCards to Address Book" etc., similar to the [https://tantek.com/microformats/2005/web2/speakers.html Web 2.0 speakers page which Tantek did a revision of last fall]. | ||
* vcard to hcard converter | * vcard to hcard converter | ||
** would be nice to have a web upload UI that would take one or more vCards from apple's address book and give them back to you as hCards | ** would be nice to have a web upload UI that would take one or more vCards from apple's address book and give them back to you as hCards | ||
Line 33: | Line 134: | ||
*** For Python: http://www.nongnu.org/python-pdi/ | *** For Python: http://www.nongnu.org/python-pdi/ | ||
*** For PHP: http://pear.php.net/package/Contact_Vcard_Parse/ | *** For PHP: http://pear.php.net/package/Contact_Vcard_Parse/ | ||
** I (Andy Pemberton) started working on this at one point, but haven't touched it in a while: [http://www.andypemberton.com/sandbox/hcardconvert/ vCard-2-hCard] | |||
* add export support for microformats to [http://www.turingart.com/abForWeb_lan__en.htm AB to Web] | * add export support for microformats to [http://www.turingart.com/abForWeb_lan__en.htm AB to Web] | ||
* A mash-up with google maps that will take any url with a hcard (or hcard's) and map the location(s) on a map (similar to [http://austin.adactio.com/ austin.adactio.com]) | * A mash-up with google maps that will take any url with a hcard (or hcard's) and map the location(s) on a map (similar to [http://austin.adactio.com/ austin.adactio.com]) | ||
Line 45: | Line 147: | ||
* [http://phpicalendar.net/documentation/index.php?title=Main_Page PHP iCalendar] | * [http://phpicalendar.net/documentation/index.php?title=Main_Page PHP iCalendar] | ||
* [http://www.vcalendar.org VCalendar] | * [http://www.vcalendar.org VCalendar] | ||
* Investigation: [ | * Investigation: [https://wiki.mozilla.org/Calendar_Talk:Lightning#hCalendar_publish_and_subscribe_support Mozilla Calendar / Lightning / Sunbird hCalendar support discussion] | ||
=== hReview === | === hReview === | ||
Line 61: | Line 163: | ||
=== WordPress patches for microformats === | === WordPress patches for microformats === | ||
* submit patches for WordPress code/templates for microformats improvement | * submit patches for WordPress code/templates for microformats improvement | ||
** <address class="vcard"> improvement in post author publication (e.g. home page of | ** <address class="vcard"> improvement in post author publication (e.g. home page of https://microformats.org/ ) | ||
* Wordpress plugin for microformats, specifically hReview and hCalendar | * Wordpress plugin for microformats, specifically hReview and hCalendar | ||
** See [http://www.surfarama.com/index.php?p=227 lazyweb request] | ** See [http://www.surfarama.com/index.php?p=227 lazyweb request] | ||
Line 79: | Line 181: | ||
===rel-tagging on Wikipedia=== | ===rel-tagging on Wikipedia=== | ||
Somebody familiar with the "rel-tag" microformat might want to add details, and a link to the relevant page on this Wiki, to the [ | Somebody familiar with the "rel-tag" microformat might want to add details, and a link to the relevant page on this Wiki, to the [https://en.wikipedia.org/wiki/Tag_%28metadata%29 Wikipedia page on tagging]. [[User:AndyMabbett|Andy Mabbett]] 14:07, 3 Jan 2007 (PST) | ||
===Glossary=== | |||
Add to the [[glossary]]. | |||
===hAtom tutorial=== | |||
Finish the [[hatom-tutorial]]. | |||
=== wiki gardening === | === wiki gardening === | ||
* Find [[:Special:Lonelypages|orphaned]] pages, and add links to them. | * Find [[:Special:Lonelypages|orphaned]] pages, and add links to them. | ||
* | * Use [[templates]] for boilerplate text and repeated lists of links | ||
* Add keywords to the foot of pages (see [[vcard-suggestions]] for examples), so that they can be converted to tags, once this wiki allows the use of "rel" attributes. Keywords can also include synonyms to aid searching. | |||
====Spelling==== | |||
Per [[how-to-play]]: for English-language pages only: Find British spellings of common words and replace them with the US spellings per [[en-US]]. Mark such edits as "minor" with the comment: <nowiki>[[en-US]]</nowiki>. Please be careful to use and maintain proper native spelling of proper nouns (see [[how-to-play]] for details). | |||
Here is a table of | Here is a table of searches for some of the British-English spellings that have crept into English-language microformats wiki pages, along with their respective US-English spellings. If you find other British spellings, please feel free to add them to this table, with their US equivalent. | ||
{| border="1" | {| border="1" | ||
|+ | |+ | ||
! en-GB !! [[en-US]] | ! [[en-GB]] !! [[en-US]] | ||
|- | |||
| [https://microformats.org/wiki/Special:Search?search=behaviour&go=Go behaviour] || behavior | |||
|- | |||
| [https://microformats.org/wiki/Special:Search?search=behaviours&go=Go behaviours] || behaviors | |||
|- | |||
| [https://microformats.org/wiki/Special:Search?search=centre&go=Go centre] || center | |||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=colour&go=Go colour] || color | ||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=colours&go=Go colours] || colors | ||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=favour&go=Go favour] || favor | ||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=flavour&go=Go flavour] || flavor | ||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=flavours&go=Go flavours] || flavors | ||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=flavoured&go=Go flavoured] || flavored | ||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=minimise&go=Go minimise] || minimize | ||
|- | |- | ||
| [ | | [https://microformats.org/wiki/Special:Search?search=minimises&go=Go minimises] || minimizes | ||
|- | |||
| [https://microformats.org/wiki/Special:Search?search=recognise&go=Go recognise] || recognize | |||
|- | |||
| [https://microformats.org/wiki/Special:Search?search=recognised&go=Go recognised] || recognized | |||
|- | |- | ||
|} | |} | ||
[https://en.wikipedia.org/wiki/American_and_British_English_spelling_differences More American and British English spelling differences] | |||
== Admins == | == Admins == | ||
This section is | This section is for folks to suggest to-do items for [[admins]], in particular, having to do with suggestions for improvements to microformats.org infrastructure such as the wiki. If you do add an item to this list, please sign your username with four tildes: <nowiki>~~~~</nowiki>. | ||
Admins check this "inbox" periodically and process and move items to [[admin-to-do]]. | |||
Please check [[admin-to-do]] to see if there is already an ongoing task item relating to your request. Otherwise add the item below. | |||
=== Website Improvements === | === Website Improvements === | ||
* | * ... | ||
=== Wiki improvements === | === Wiki improvements === | ||
:< | * Want: Right-to-left (RTL) support in the theme for better translating to RTL languages. Per [https://www.facebook.com/permalink.php?story_fbid=10150109554926465&id=214611 this comment on the microformats page on Facebook 2011-02-13]: <blockquote><cite>Sina Cheraghi</cite> > Microformats <br> "I want to contribute in Microformats wiki by translating it into Persian. But lack of RTL (right-to-left) languages (Persian, Arabic, Hebrew and ...) theme causes some problems for me and other contributors."</blockquote> | ||
. | |||
* | * Make email addresses editable [[User:Singpolyma|Singpolyma]] 02:47, 26 July 2009 (UTC) | ||
: | ** How would this work and what's the purpose? [[User:Tantek|Tantek]] 02:39, 10 September 2009 (UTC) | ||
== Below this section needs rethinking and triaging == | |||
All the person-specific to-do items here need rethinking in the current context of how we use and develop microformats, and current community needs. | |||
Nearly all of the below was written ''before [[microformats2]]'', and thus may only be applicable in a historical context, or needs to be reimagined in a microformats2 context. | |||
How to rethink and triage the below: | |||
# Assume that while captured in good-faith and with good intentions, nearly everything below is now obsolete and/or the person who added it under their name has gone on to do other things. | |||
# Feel free to use the below for inspiration for what things ''could be'' done, and copy & rewrite them in a modern context in the previous (above) non-person-specific sections (to make it clear that anyone is welcome to help work on them). | |||
# Maybe after a person’s previous to-do items have all been rethought/triaged into modern to-do items above, their section can be moved to an "Emeritus" subsection down at the bottom | |||
#* Emeritus subsection to be created. | |||
Thoughts? | |||
* Tantek: I'm ok with the items listed under my name being *cut* and pasted (with modern updates) incrementally into the above sections, no need to preserve them after they've been rethought. | |||
** Please keep them around until they have been rethought | |||
** Ideally do the cut and paste in the same edit so it's clear where something moved in the wiki-edit-diff. | |||
* ... | |||
== --- == | |||
== Tantek == | == Tantek == | ||
I'm keeping | I'm keeping microformats related to-do items here both for my own convenience, and for folks looking to help out. - [https://tantek.com Tantek]. | ||
=== overall priority ordering === | === overall priority ordering === | ||
# Protect the community from threats (wiki damage, mailing list pain or noise), repair damage, add measures to reduce future damage | # Protect the community from threats (wiki damage, mailing list pain or noise), repair damage, add measures to reduce future damage | ||
# | # Update [[microformats2-parsing]] with resolved [[microformats2-parsing-issues]] | ||
# Help implementers with established microformats | # Help implementers with established microformats | ||
# Iterate on existing established microformats, resolve issues/feedback etc. | # Iterate on existing established microformats, resolve issues/feedback etc. | ||
Line 163: | Line 279: | ||
# Site usability of microformats.org top-down as an entry point | # Site usability of microformats.org top-down as an entry point | ||
# Community dynamics, [[process]] and [[principles]] improvements to help guide new microformats developments | # Community dynamics, [[process]] and [[principles]] improvements to help guide new microformats developments | ||
# | # Wrap up classic microformats documentation | ||
# Document microformats [[history]]. | # Document microformats [[history]]. | ||
# Other | # Other | ||
=== protect the community === | === protect the community === | ||
* Analyze [[Special:Recentchanges]] and [ | * Analyze [[Special:Recentchanges]] and [https://microformats.org/discuss mailing-lists] and: | ||
** add to [[mailing-lists]] policies/guidelines accordingly. | ** add to [[mailing-lists]] and [[how-to-play]] policies/guidelines accordingly. | ||
** redirect and resolve threads accordingly per guidelines | ** redirect and resolve threads accordingly per guidelines | ||
** privately email violaters kindly asking them to improve their behavior | ** privately email violaters kindly asking them to improve their behavior | ||
** work with admins on next steps for individuals negatively impacting the community | ** work with admins on next steps for individuals negatively impacting the community | ||
** recognize noisy/distracting threads on the email list, document responses/answers to such subjects on the appropriate page(s) on the wiki, and reply to those threads with the URLs to the documentation on the wiki. Putting the responses/answers on the wiki helps by hopefully providing preemptive answers to some who might reraise the subjects on the list in the future, and helps the community quickly terminate such threads by using the answers on the wiki. | ** recognize noisy/distracting threads on the email list, document responses/answers to such subjects on the appropriate page(s) on the wiki, and reply to those threads with the URLs to the documentation on the wiki. Putting the responses/answers on the wiki helps by hopefully providing preemptive answers to some who might reraise the subjects on the list in the future, and helps the community quickly terminate such threads by using the answers on the wiki. | ||
** | ** move exploratory discussions which are failing to follow the process to a separate page from that | ||
*** | ** repair damage done to the wiki | ||
*** move | *** identify damage done to the wiki - often in forms as simple as content changes that hurt usability (and thus accessibility) | ||
*** document additional [[how-to-play]] guidelines to discourage and hopefully reduce such wiki damaging behavior in the future | |||
*** repair/undo/reorganize page section division that hurt usability (and thus accessibility) | |||
**** [[hcalendar-examples-in-wild]] | |||
***** afterwards add some of the excellent conference schedule calendars that [[User:Adactio]] has been creating like: | |||
****** https://adactio.com/extras/schedules/barcampbrighton3/ | |||
*** repair/undo/reorganize page splitting that hurt usability (and thus accessibility) | |||
**** [[to-do]] | |||
=== update microformats2-parsing with resolved issues === | |||
Update [[microformats2-parsing]] with resolved [[microformats2-parsing-issues]] | |||
=== help implementers === | |||
Update all these tasks for [[microformats2]]: | |||
* wordpress improvements | |||
** WP admin for new profiles | |||
*** should simply read blog URL - '''next-action''': make sure a bug/feature request is filed with wordpress.org | |||
*** look for hCards and parse them | |||
* [http://gmpg.org/xfn/creator XFN Creator] localizations | |||
** Get someone to verify the [http://gmpg.org/xfn/creator-ru XFN Creator Russian localization]. | |||
** Add it to the [http://gmpg.org/xfn/tools XFN Tools] page. | |||
** Add rel="alternate" href="creator-ru" <link>s to the other XFN Creators. | |||
* Conference Schedule Creator | |||
** '''next-actions''': Review Dmitry Baranovskiy's [http://dmitry.baranovskiy.com/work/csc/ Conference Schedule Creator] and give him feedback per how well it: | |||
*** Makes it *trivial* for conference organizers to build/edit/publish an [[hcalendar|hCalendar]] schedule for their conference, including auto-generated "Subscribe..." link which produces the proper "webcal:..." link with X2V. Note: see the "axis" and "header" attributes in HTML4, specifically in the section on Tables. | |||
=== wiki cleanup === | |||
Update all these tasks for [[microformats2]]: | |||
==== for all microformat specs ==== | |||
'''Next-actions''': | |||
* modularize any specs which are > 30K in order to avoid loss/corruption like [https://microformats.org/wiki?title=Special:Contributions&target=Evan Evan's 14 June edits] to [[hcard|hCard]], [[rel-tag]], and [[xoxo|XOXO]]. | |||
** [[hcard|hCard]] - | |||
*** [[hcard-examples-in-the-wild]] group/sort by individuals, organizations, and hosting sites. Consider moving largest subsection to its own page as well. | |||
** [[rel-tag]] | |||
** [[xoxo]] | |||
==== update specification section organization ==== | |||
'''Goal''': greater approachability/readability of microformats specs by a broader audience. | |||
Reference: | |||
* [[hresume|hResume]] has an experimental abbreviated intro/headers section, and links to more details further below, based on some ideas that Ryan King and I had for improving the readability of the microformats specifications. | |||
* [[hreview|hReview]] has some similar improvements, but different. | |||
* [[hcard|hCard]] has numerous improvements as well, again different from either hResume or hReview | |||
'''Next-actions''': | |||
# contact microformats community members who are content/tutorial authors, and/or have written (or are writing) technical books, and those who have made concrete helpful suggestions for reorganizing the information architecture / content-order / layout of specs. | |||
# figure out if the new intro/headers etc. structure/order in [[hcard|hCard]], [[hreview|hReview]], and [[hresume|hResume]] is an improvement, and if it could be better. Document reasoning/requirements for intro/header and other sections. | |||
#* Shorter tends to be better | |||
#* Must be comprehensive enough to "print and read" | |||
#* Must detail authorship/editorship | |||
#* Must detail copyright/patent statements | |||
# Design an iterative update to spec organization, in particular, the introduction/boilerplate/headers. | |||
# Write up a template - make it self-documenting per the requirements | |||
# Update existing specifications with the new intro/headers structure. | |||
## [[hcard|hCard]] | |||
## [[hcalendar|hCalendar]] | |||
## [[hreview|hReview]] | |||
# Write up methodology behind the section organization and note editors lessons learned into an [[editors-guide]] page (what other variants were done before, in which specs, and note problems/complaints with other variants). | |||
==== reorganizing Implementations sections ==== | |||
* sort implementations by authoring/creating/publishing, browsing/viewing, converting/importing, indexing/searching. | |||
Hmmm... I like: '''A'''uthoring, '''B'''rowsing, '''C'''onverting, '''I'''ndexing, '''L'''ibraries (for developers), and '''P'''otential (for open source projects we want to add support to). Anybody have alternative suggestions for this vocabulary? I don't have a particularly strong preference so I'm going to go with these four until I find examples that don't fit, or someone suggests something better. | |||
See: [https://microformats.org/wiki/hcalendar#Implementations hCalendar Implementations] for a first attempt at this. Assuming folks like that, we can go ahead with categorizing the implementations sections of other microformats specifications. | |||
'''Next-actions''': | |||
* [[hcard-implementations]] - re-organize by same subsections as [[hcalendar-implementations]]. | |||
* [[hreview-implementations]] - re-organize by same subsections as [[hcalendar-implementations]]. | |||
* [[hatom-implementations]] - re-organize by same subsections as [[hcalendar-implementations]]. | |||
* [[xfolk-implementations]] - re-organize by same subsections as [[hcalendar-implementations]]. | |||
==== reorg Examples in the Wild sections ==== | |||
Work with community to: | |||
* include more *key* details per example, e.g. precise or estimates of counts for services | |||
* collate/sort examples in the wild by | |||
** hosting services - where users/people actively contribute to the growth (e.g. Flickr profile hCards) | |||
** publishing services - where lots of data is published from some datasource/database (e.g. Yahoo! Local) | |||
** companies/groups/organizations member pages (and their own) - pages for a group's site where they list members or employees (e.g. Technorati staff page) | |||
** individiual companies/organizations contact info pages | |||
** individual people's contact info pages | |||
* of course at some point this won't scale, but that will be a very good problem to have, and by then I'm sure we'll have services to point to that provide queries and search results for all this data. | |||
=== site usability === | |||
Update all these tasks for [[microformats2]]: | |||
* figure out how to get wordpress to autopost blog posts to the microformats-announce list | |||
** ideally use the from address of the author of the blog post | |||
** maybe photomatt knows how to do this. | |||
=== introduction / community === | |||
Update all these tasks for [[microformats2]]: | |||
* microformats-discuss * | |||
** introductory email template for new subscribers needs to direct people to [[process]] and [[how-to-play]] | |||
* Need to add more to the [[naming-principles]], to cover in particular: | |||
** avoid using the same name to mean two things | |||
** avoid using two names to mean the same thing | |||
** seek to keep the microformats vocabulary minimal, memorable, and usable. | |||
* update and add details/simplifications to [[process]] given the past several months of experience. in particular: | |||
** clarify requirement (MUST rather than SHOULD) of *-examples, *-formats, before any *-brainstorming. | |||
** Add details of encouragement to experiment with simple semantic class names from *-brainstorming proposals to gain real world experience with real world content. | |||
** note SHOULD prerequisite of use of all relevant microformats on real world web pages, along with documenting such use in respective "Examples in the Wild" sections, before proposing any new microformats. | |||
==== posh improvement ==== | |||
* Create a page to answer the question "[[how-should-i-markup]]" | |||
* consider creating a process/encouragement for collecting individual [[posh]] practices and examples, like a folksonomy of semantic HTML and semantic class names. | |||
==== principles and process ==== | |||
Create the following pages and document/fill them with content from other pages, email lists, and [[presentations]]. | |||
* [[principles]] - mostly [[microformats#the_microformats_principles|documented in the microformats]] page. | |||
* clearer statement of both copyright and patents both in specific specs and in general | |||
* resolve [[process-issues]] | |||
==== profiles ==== | |||
* update [[XMDP]] with new required features: | |||
** ability for one profile to include/import another (rel="import" ?) | |||
** ability to reference an XMDP via rel="profile" (similar to XHTML2 rel value by same name) | |||
*** add rel="profile" to the [[xmdp-profile]]. | |||
** ability/suggestion to reference an XMDP using <a href> in addition to <link> | |||
==== community mark ==== | |||
* Can we make "microformat" and "microformats" into [http://factoryjoe.com/blog/2006/01/14/the-case-for-community-marks/ Community Marks]? | |||
==== document issue resolutions ==== | |||
* Prefixing has already been considered and rejected for microformats in general. Note [[naming-conventions]], limited vocabulary, and exceptions made for [[hatom|hAtom]] and how we went about doing so. | |||
=== emerging microformats === | |||
Update all these tasks for [[microformats2]]: | |||
* [[directions]] | |||
* [[citation]] | |||
* [[hlisting|hListing]] | |||
* [[media-info]] | |||
* [[licensing]] | |||
'''Next-actions''' for each emerging microformat (one at a time) | |||
* review all microformats-email on the new microformat | |||
* determine where new microformats is "stuck" in the process | |||
* brainstorm about how to improve process (or documentation thereof) to get the effort unstuck | |||
* work with community to move the microformat forward through the process, iterating/clarifying the [[process]] as necessary | |||
=== new microformat requests === | |||
Update all these tasks for [[microformats2]]: | |||
* expense reports (really just a list of "expense" items), [http://flickr.com/photos/edyson/56774178/ requested by ED], should look at UBL as a pre-existing format | |||
* photo-notes microformat | |||
** clean up Subethaedit notes from working session with Greg Elin, Ryan King, Kevin Marks, Suw Charman and email to folks and figure out next steps | |||
** iterate on [[photo-note-examples]] and start [[photo-note-formats]] and [[photo-note-brainstorming]]. | |||
=== wrap up classic microformats documentation === | |||
* use these tasks to come up with any necessary or useful equivalents for [[microformats2]] specifications and resources. | |||
===== minor update current specifications ===== | |||
* draft hCard 1.0.1: [[hcard|hCard spec]] '''next-actions''': | |||
** <del>resolve remaining [[hcard-issues|hCard issues]]</del> | |||
** close remaining [[hcard-issues-resolved|hCard resolved issues]] by writing necessary [[hcard-faq|FAQ]] entries, updating [[hCard]], and adding to [[hcard-brainstorming]] for 1.0.1 and 1.1. | |||
** draft [[hcard-1-0-1]] by starting with [[hcard-1-0]] and incorporating [[hcard-brainstorming]] targeted for 1.0.1. | |||
** incorporate [[hcard-feedback]] | |||
** continue updating the spec per the inline comment about property references | |||
** add a brief descriptive sentence for each property, similar to what [[hreview|hReview]] has. just enough so that the casual reader can avoid having to reference and read the respective sections in [[RFC2426]]. add any non-trivial information about each property similar to what [[hreview|hReview]] has. | |||
** iterate [[hcard-parsing]] with [[value-class-pattern]] as a required feature | |||
** iterate [[hcard-parsing]] with sufficient table element special handling to do people equivalent of [https://microformats.org/wiki/hcalendar- brainstorming#Tabular_event_calendars] | |||
** iterate [[hcard-parsing]] with how to handle new or different [[HTML5]] markup such as the <code><time></code> element, including at least one test case with the <code><time></code> element. | |||
** [[hcard-brainstorming]] '''next-actions''': determine which brainstorms proposals to resolve for minor revision, and which later | |||
** Update [[semantic-xhtml]] with lists of semantic [https://www.w3.org/TR/html401/index/elements.html elements] and [https://www.w3.org/TR/html401/index/attributes.html attributes]. | |||
** Update [[hcard-brainstorming]] on element specific parsing rules | |||
** Update X2V, hKit, Operator accordingly | |||
** Write test cases accordingly | |||
** Update [[hcard-parsing]] accordingly | |||
* draft hCalendar 1.0.1: [[hcalendar|hCalendar spec]] '''next-actions''': | |||
** <del datetime="2009-10-03">resolve all outstanding [[hcalendar-issues]] into [[hcalendar-issues-resolved]]</del> | |||
** close remaining [[hcalendar-issues-resolved|hCalendar resolved issues]] by writing necessary [[hcalendar-faq|FAQ]] entries, updating [[hCalendar]], and adding to [[hcalendar-brainstorming]] for 1.0.1 and 1.1. | |||
** draft [[hcalendar-1-0-1]] by starting with [[hcalendar-1-0]] and incrementally incorporating [[hcalendar-brainstorming]] targeted for 1.0.1 | |||
** incorporate [[hcalendar-feedback]] | |||
** itemize a complete property list similar to the [[hcard#Property_List|hCard property list]], drawing upon hCalendar experience, iCal-BASIC draft(s), ietf-calsify mailing list and other sources to derive the precise list. Separate common properties up front. | |||
** add a brief descriptive sentence for each property, similar to what [[hreview|hReview]] has. just enough so that the casual reader can avoid having to reference and read the respective sections in [[RFC2445]]. add any non-trivial information about each property similar to what [[hreview|hReview]] has. | |||
** significantly update and thoroughly specify [[hcalendar-parsing]] with [[value-class-pattern]] as a required feature | |||
** formally document [https://microformats.org/wiki/hcalendar- brainstorming#Tabular_event_calendars] | |||
** iterate [[hcalendar-parsing]] with how to handle new or different [[HTML5]] markup such as the <code><time></code> element, including at least one test case with the <code><time></code> element. | |||
** [[hcalendar-examples]] | |||
*** make sure all hCalendar examples that reference whole days use best international/accessible date format of YYYY-MM-DD | |||
*** add explicit explanation and examples for LOCATION [[hcard|hCards]] and ATTENDEE [[hcard|hCards]], perhaps on a separate [[hcalendar-examples]] page. | |||
** Write [[compound-parsing]] by abstracting commonalities between [[hcard-parsing]] and [[hcalendar-parsing]]. | |||
* draft hReview 0.4 | |||
* resolve hAtom issues | |||
* co-edit hAtom per permission from David Janes | |||
* draft [[hAtom]] 0.2 | |||
** Clarify that "published" property values may omit seconds, and that converters to Atom are expected to imply ":00" seconds. | |||
* add sections for comments/opinion from community as well as issues subsection | |||
* solicit feedback | |||
* when sufficient consensus and issue resolution achieved, archive previous versions of specs, and update spec pages accordingly. | |||
==== social network portability ==== | ==== social network portability ==== | ||
Iterate on: | Iterate on: | ||
Line 200: | Line 508: | ||
* gather feedback on current foldup [[pocket-cheat-sheet|pocket cheatsheet]] | * gather feedback on current foldup [[pocket-cheat-sheet|pocket cheatsheet]] | ||
* document the [[pocket-cheat-sheet-feedback|feedback on the pocket cheatsheet]] | * document the [[pocket-cheat-sheet-feedback|feedback on the pocket cheatsheet]] | ||
* provide printing recommendations for anyone to download and print their own | * provide printing recommendations for anyone to download and print their own | ||
** Perhaps [http://www.visibone.com/ Visibone] can be of some use? I can recommend their current products. --[[User:Gazza|Gazza]] 06:41, 7 Apr 2007 (PDT) | ** Perhaps [http://www.visibone.com/ Visibone] can be of some use? I can recommend their current products. --[[User:Gazza|Gazza]] 06:41, 7 Apr 2007 (PDT) | ||
* update cheatsheet to include new [[value-class-pattern]] uses | |||
* give feedback to Erin or ask for volunteers to create a new cheatsheet, iterate, print more to have on hand, fold, distribute. | |||
* discuss with [[User:Adactio]] and Hannah how to best create a UK/A4 version of the pocket cheatsheet | |||
** preferably well in advance of dConstruct 2008 so that local cheatsheets can be printed. | |||
==== *-authoring microformats wiki pages ==== | ==== *-authoring microformats wiki pages ==== | ||
* [[hcard-authoring]] - '''next-actions''': add tips/instructions noted below. | * [[hcard-authoring]] - '''next-actions''': add tips/instructions noted below. | ||
** instructions for each property that is in [ | ** instructions for each property that is in [https://microformats.org/code/hcard/creator hCard creator] to begin with | ||
** instructions for all other hCard properties | ** instructions for all other hCard properties | ||
** a tutorial on creating an hCard for your site | ** a tutorial on creating an hCard for your site | ||
Line 214: | Line 525: | ||
* [[hcard-xfn-authoring]] - '''next-action''': draft by starting from hCard+XFN instructions in [[hcard-examples]]. | * [[hcard-xfn-authoring]] - '''next-action''': draft by starting from hCard+XFN instructions in [[hcard-examples]]. | ||
* [[hreview-authoring]] - '''next-action''': create a first draft minimal tutorial on how to author hReviews (e.g. at least for common properties) to blog reviews so that they'll be aggregated. | * [[hreview-authoring]] - '''next-action''': create a first draft minimal tutorial on how to author hReviews (e.g. at least for common properties) to blog reviews so that they'll be aggregated. | ||
* [[hcalendar-authoring]] - '''next-action''': add tips/instructions for each property that is in [ | * [[hcalendar-authoring]] - '''next-action''': add tips/instructions for each property that is in [https://microformats.org/code/hcalendar/creator hCalendar creator]. | ||
* *-authoring for other reasonably well established microformats: | * *-authoring for other reasonably well established microformats: | ||
** [[xfolk-authoring]], [[hatom-authoring]] | ** [[xfolk-authoring]], [[hatom-authoring]] | ||
Line 247: | Line 558: | ||
*** publishing/providing open data (e.g. microformats) can be done by any HTML author (yes, you), whereas providing/publishing open APIs requires programming expertise, resouces, and support. do the simpler easier thing first (open data thru microformats) that will benefit more people sooner. | *** publishing/providing open data (e.g. microformats) can be done by any HTML author (yes, you), whereas providing/publishing open APIs requires programming expertise, resouces, and support. do the simpler easier thing first (open data thru microformats) that will benefit more people sooner. | ||
==== in general ==== | ==== in general ==== | ||
===== plain language intros ===== | ===== plain language intros ===== | ||
Line 281: | Line 576: | ||
===== update affiliations ===== | ===== update affiliations ===== | ||
* Start a minimal draft/spec style guide using outline of most readable/accessible spec so far | * Start a minimal draft/spec style guide using outline of most readable/accessible spec so far | ||
* Reference | * Reference https://www.w3.org/2001/06/manual/#Editors for how to manage affiliations | ||
* Update affiliations on [[hcard]], [[hcalendar]], [[hreview]], etc. per | * Update affiliations on [[hcard]], [[hcalendar]], [[hreview]], etc. per https://www.w3.org/2001/06/manual/#Editors | ||
===== profile URLs ===== | ===== profile URLs ===== | ||
* write-up and document [[profile-uris|profile URLs]] for all established microformats and perhaps for some drafts as well | * write-up and document [[profile-uris|profile URLs]] for all established microformats and perhaps for some drafts as well | ||
Line 288: | Line 583: | ||
==== [[hcard|hCard]] ==== | ==== [[hcard|hCard]] ==== | ||
Combined next-actions for iteration on [[hcard|hCard]], and derived/subsetted microformats [[adr]] and [[geo]] | Combined next-actions for iteration on [[hcard|hCard]], and derived/subsetted microformats [[adr]] and [[geo]] | ||
* [[hcard-profile]] '''next-actions''': | * [[hcard-profile]] '''next-actions''': | ||
** update property definitions with more detail using semantics from [[RFC2426]] | ** update property definitions with more detail using semantics from [[RFC2426]] | ||
Line 297: | Line 589: | ||
* [[hcard-examples]] '''next-actions''': update with examples described below | * [[hcard-examples]] '''next-actions''': update with examples described below | ||
** add examples of [[hcard|hCard]]s with work telephone, mailing address etc. | ** add examples of [[hcard|hCard]]s with work telephone, mailing address etc. | ||
** add examples of marking up an organization vs. a person, then link to it from [ | ** add examples of marking up an organization vs. a person, then link to it from [https://microformats.org/wiki/hcard#Organization_Contact_Info hCard spec section on Organization Contact Info]. | ||
** add example of organization-name and organization-unit usage. | ** add example of organization-name and organization-unit usage. | ||
* [[hcard-brainstorming]] '''next-actions''': explore brainstorms proposals for a 1.1 revision, e.g. | |||
* [[hcard-brainstorming]] '''next-actions''': | |||
** need property for gender (see [[hcard-faq#How_is_gender_represented|proposal in hCard FAQ]] and discussion in [[hcard-issues]]) - use tags for now, add to hCard creator | ** need property for gender (see [[hcard-faq#How_is_gender_represented|proposal in hCard FAQ]] and discussion in [[hcard-issues]]) - use tags for now, add to hCard creator | ||
** solve [[hcard-brainstorming#Auto-Discovery|autodiscovery]] of more canonical/thorough hCard | ** solve [[hcard-brainstorming#Auto-Discovery|autodiscovery]] of more canonical/thorough hCard | ||
* [[hcard-examples-in-wild]] | * [[hcard-examples-in-wild]] | ||
** help dglazkov markup: http://glazkov.com/blog/archive/2003/12/17/147.aspx | ** help dglazkov markup: http://glazkov.com/blog/archive/2003/12/17/147.aspx | ||
* analyze [[hcard-cheatsheet]], [[adr-cheatsheet]], [[geo-cheatsheet]] for any assertions above and beyond what the specification itself says, take into account [[hcard-brainstorming]] along similar lines, and incorporate into the spec or remove as necessary and sync-up as a result. add clarification on the cheatsheets that they are '''informative''' and reference the specification for normative requirements. | * analyze [[hcard-cheatsheet]], [[adr-cheatsheet]], [[geo-cheatsheet]] for any assertions above and beyond what the specification itself says, take into account [[hcard-brainstorming]] along similar lines, and incorporate into the spec or remove as necessary and sync-up as a result. add clarification on the cheatsheets that they are '''informative''' and reference the specification for normative requirements. | ||
==== [[hcalendar|hCalendar]] ==== | ==== [[hcalendar|hCalendar]] ==== | ||
'''Next-actions''': | '''Next-actions''': | ||
* | * update [[hcalendar-examples]] | ||
** add examples like [[hcard-examples]] | ** add examples like [[hcard-examples]] | ||
** flesh out and do a once over on markup/presentation of what RFC2445 examples would look like | ** flesh out and do a once over on markup/presentation of what RFC2445 examples would look like | ||
** | ** update all hcalendar-examples to use value-title from [[value-class-pattern]] where abbr doesn't make sense. e.g. | ||
*** rrule | |||
*** duration | |||
*** ... etc. | |||
* need spec details and then [[hcalendar-examples]] of multi-instance [[hcalendar|hCalendar]] events | * need spec details and then [[hcalendar-examples]] of multi-instance [[hcalendar|hCalendar]] events | ||
* need spec details and then [[hcalendar-examples]] of repeating events | * need spec details and then [[hcalendar-examples]] of repeating events | ||
* | * have folks verify [[hcalendar-profile]]. Note that it will likely need reconciliation with the [[hcard-profile]], especially since [[hcalendar|hCalendar]] normatively depends on [[hcard|hCard]]. Probably makes sense to have a combined profile which hCalendar would use. | ||
* analyze [[hcalendar-cheatsheet]] for any assertions above and beyond what the specification itself says, take into account [[hcalendar-brainstorming]] along similar lines, and incorporate into the spec or remove as necessary and sync-up as a result. add clarification on the cheatsheets that they are '''informative''' and reference the specification for normative requirements. | * analyze [[hcalendar-cheatsheet]] for any assertions above and beyond what the specification itself says, take into account [[hcalendar-brainstorming]] along similar lines, and incorporate into the spec or remove as necessary and sync-up as a result. add clarification on the cheatsheets that they are '''informative''' and reference the specification for normative requirements. | ||
==== [[hreview|hReview]] ==== | ==== [[hreview|hReview]] ==== | ||
'''Next-actions''': | '''Next-actions''': | ||
* | * reconcile [[hreview-profile|hReview 0.4 XMDP profile]] with [[hcalendar-profile]] and [[hcard-profile]]. Makes sense to have a combined profile of all three for hReview, since hReview normatively depends on hCard and hCalendar. | ||
* Resolve all outstanding [[hreview-issues]] and [[hreview-feedback]] to-do items. | * Resolve all outstanding [[hreview-issues]] and [[hreview-feedback]] to-do items. | ||
==== [[rel-tag]] ==== | ==== [[rel-tag]] ==== | ||
'''Next-actions''': | '''Next-actions''': | ||
* | * send [[rel-tag]] XMDP profile ([[rel-tag-profile]]) to [https://dbaron.org/ David Baron]. | ||
* Resolve all outstanding [[rel-tag-issues]] and [[rel-tag-feedback]] to-do items. | * Resolve all outstanding [[rel-tag-issues]] and [[rel-tag-feedback]] to-do items. | ||
==== [[rel-me]] ==== | ==== [[rel-me]] ==== | ||
'''Next-actions''': | '''Next-actions''': | ||
* update rel-me examples | * move XFN and XMDP FAQs, tutorial, descriptions, spec etc. from gmpg.org to microformats.org | ||
** and put redirects in place, notes about contribution | |||
* update rel-me examples and document with examples the rel-me implict subdir rule | |||
==== [[hatom|hAtom]] ==== | ==== [[hatom|hAtom]] ==== | ||
'''Next-actions''': | '''Next-actions''': | ||
==== summary Examples in the Wild page ==== | ==== summary Examples in the Wild page ==== | ||
* need to create a summary / overall [[examples-in-the-wild]] page | * need to create a summary / overall [[examples-in-the-wild]] page | ||
** parallel the summary/overall [[implementations]] page. | ** parallel the summary/overall [[implementations]] page. | ||
** use newly | ** use newly reorganized content from the above "reoganizing Examples in the Wild" task | ||
==== parsing ==== | ==== parsing ==== | ||
'''Next-actions''': | '''Next-actions''': | ||
* Draft *-parsing for all reasonably well adopted microformats: [[hreview-parsing]], [[xfolk-parsing]], [[hatom-parsing]] | |||
* Draft *-parsing for all reasonably well adopted microformats: | |||
=== document microformats history === | === document microformats history === | ||
Line 473: | Line 651: | ||
==Ryan== | ==Ryan== | ||
=== wiki cleanup === | === wiki cleanup === | ||
* possibly move dead proposals off of homepage? | * <s>possibly move dead proposals off of homepage?</s> | ||
=== hCalendar/hCard/hReview creator improvements === | === hCalendar/hCard/hReview creator improvements === | ||
Line 521: | Line 699: | ||
* better microformats wiki theme | * better microformats wiki theme | ||
* Define flow for OpenID + XFN + hcard (see [http://diso-project.org DiSo Project]) | * Define flow for OpenID + XFN + hcard (see [http://diso-project.org DiSo Project]) | ||
Hey Chris. | |||
Congrats on Microsyntax | |||
([http://factoryjoe.com/blog/2009/05/26/stowe-boyd-launches-microsyntax-org/ "Stowe Boyd launches Microsyntax.org"]). | |||
So ... do we need a page on this Microformats wiki describing the connection between microformats and microsyntax? | |||
== Robert Bachmann == | == Robert Bachmann == | ||
Line 530: | Line 713: | ||
<ul> | <ul> | ||
<li>Do some refactoring, split Perl code into smaller modules</li> | <li>Do some refactoring, split Perl code into smaller modules</li> | ||
<li>Provide test results as HTML pages (similar to | <li>Provide test results as HTML pages (similar to https://www.w3.org/2003/08/owl-systems/test-results-out)</li> | ||
<li>Provide some documentation for using the test scripts</li> | <li>Provide some documentation for using the test scripts</li> | ||
</ul> | </ul> | ||
Line 651: | Line 834: | ||
* Medium term | * Medium term | ||
** sync [[hcalendar-tests]] and [ | ** sync [[hcalendar-tests]] and [https://www.w3.org/2002/12/cal/ RDF calendar] tests and CALSIFY | ||
*** reconsider RDF calendar naming conventions | *** reconsider RDF calendar naming conventions | ||
** update my CV/resume using [[hResume]] and [[citation-formats]] | ** update my CV/resume using [[hResume]] and [[citation-formats]] | ||
*** get an answer from the CALSIFY WG re [ | *** get an answer from the CALSIFY WG re [https://lists.w3.org/Archives/Public/www-rdf-calendar/2006Apr/0006.html dtstart and date vs datetime ] 21 Apr 2006 | ||
*** refine [[hatom]] so that it's suitable for the workflow around the W3C homepage. | *** refine [[hatom]] so that it's suitable for the workflow around the W3C homepage. | ||
Line 661: | Line 844: | ||
* Someday pile | * Someday pile | ||
** set up a timezone registry based on wikipedia and semantic mediawiki. As discussed in [[datetime-design-pattern]], iCalendar's by-value timezone passing is broken. see [ | ** set up a timezone registry based on wikipedia and semantic mediawiki. As discussed in [[datetime-design-pattern]], iCalendar's by-value timezone passing is broken. see [https://lists.w3.org/Archives/Public/www-rdf-calendar/2006Apr/0002.html reconsidering timezones in light of hCalendar and CALSIFY] and [http://dig.csail.mit.edu/breadcrumbs/node/91 Toward Semantic Web data from Wikipedia] | ||
** noodle on a playlist format and some of the media RSS stuff like [[media-info-brainstorming]], [[media-metadata-examples]] (re playlists: XSPF, SMIL, RDF, and microformats 9 Sep 2005) | ** noodle on a playlist format and some of the media RSS stuff like [[media-info-brainstorming]], [[media-metadata-examples]] (re playlists: XSPF, SMIL, RDF, and microformats 9 Sep 2005) | ||
** check out that hReview bug stuff... | ** check out that hReview bug stuff... | ||
Line 692: | Line 875: | ||
[[Christophe Ducamp]] | [[Christophe Ducamp]] | ||
* seed "microformateurs group" and invite them to update | * seed "microformateurs group" and invite them to update https://microformateurs.org | ||
** write a process for newbies in order to make them write [[posh-fr|CHIC]] posts on a public blog-governed-by-wiki ([http://socialsynergyweb.net/cgi-bin/wiki/MicroFormateurs/Blog]) before publication. | ** write a process for newbies in order to make them write [[posh-fr|CHIC]] posts on a public blog-governed-by-wiki ([http://socialsynergyweb.net/cgi-bin/wiki/MicroFormateurs/Blog]) before publication. | ||
** find experts for peer-reviewing | ** find experts for peer-reviewing | ||
Line 719: | Line 902: | ||
[[User:Phae|Frances Berriman]] | [[User:Phae|Frances Berriman]] | ||
* | * Clean up this todo list (meta!) | ||
* | ** Move alumni admin tasks out, and into a 'up for grabs' bucket (unless 100% specific to person). | ||
* | *** Ping anyone with specific tasks / nag | ||
* | * Proposal for page simplifications - notes, to expand to tasks later: | ||
** | ** Need a way to push active formats (those in the process) to the fore, and push back stagnating items. | ||
** | ** Process updates to blog? | ||
** Activity overview updates on main site somewhere? | |||
*** Code and Tools page on site: Currently it's mostly only tools. Need to add a list of actual specifications on the wiki. | |||
** In general: less clutter, more structure, more focus. | |||
== Ben West (bewest) == | == Ben West (bewest) == | ||
Line 743: | Line 929: | ||
* "boil the ocean" A huge task. "A phrase used in the industry to describe an attempt at something that is way too ambitious. For example, "They're trying to get their site launched by COMDEX. They could easier boil the ocean." from <http://www.netlingo.com/right.cfm?term=boil%20the%20ocean> | * "boil the ocean" A huge task. "A phrase used in the industry to describe an attempt at something that is way too ambitious. For example, "They're trying to get their site launched by COMDEX. They could easier boil the ocean." from <http://www.netlingo.com/right.cfm?term=boil%20the%20ocean> | ||
* microformats: more than one microformat | * microformats: more than one microformat | ||
* microformat: see my definition on | * microformat: see my definition on https://microformats.org/wiki/what-are-microformats#BenWest | ||
* data fidelity: the extent to which a data format might be considered lossy. eg HTML is often seen as a lossy format because the information parsed out of a resource may not fully match the information orginally encoded. Non-lossy formats have a very high data fidelity, while lossy formats have low data fidelity. Microformats seek to increase data fidelity of html. | * data fidelity: the extent to which a data format might be considered lossy. eg HTML is often seen as a lossy format because the information parsed out of a resource may not fully match the information orginally encoded. Non-lossy formats have a very high data fidelity, while lossy formats have low data fidelity. Microformats seek to increase data fidelity of html. | ||
* market: the locus of economic forces | * market: the locus of economic forces | ||
Line 816: | Line 1,002: | ||
My suggestion on the list was for us to use a convention that the entry page (i.e. | My suggestion on the list was for us to use a convention that the entry page (i.e. | ||
https://microformats.org/wiki/hcard) would be an index into a list of | |||
(psuedo) standardized sub pages so that it would be very people to | (psuedo) standardized sub pages so that it would be very people to | ||
find what is important to them. For example, is a list of potential sub pages: | find what is important to them. For example, is a list of potential sub pages: | ||
Line 835: | Line 1,021: | ||
These pages would be located respectively at | These pages would be located respectively at | ||
* | * https://microformats.org/wiki/hcard/ | ||
** | ** https://microformats.org/wiki/hcard/Specification | ||
** | ** https://microformats.org/wiki/hcard/Tutorial | ||
** | ** https://microformats.org/wiki/hcard/Examples | ||
** | ** https://microformats.org/wiki/hcard/Use_cases | ||
** | ** https://microformats.org/wiki/hcard/Reference | ||
** | ** https://microformats.org/wiki/hcard/Discussion | ||
** | ** https://microformats.org/wiki/hcard/Brainstorming | ||
** | ** https://microformats.org/wiki/hcard/Implementations | ||
** | ** https://microformats.org/wiki/hcard/Related_Pages | ||
** | ** https://microformats.org/wiki/hcard/Further_Reading | ||
** | ** https://microformats.org/wiki/hcard/All | ||
Please note I am suggesting an architecture not a specific list of sub pages. The list of sub pages should be defined by both reviewing existing information during site reorganization, and then via discussion on the list in an attempt to discover and extract which sub pages are needed for most/all microformats. | Please note I am suggesting an architecture not a specific list of sub pages. The list of sub pages should be defined by both reviewing existing information during site reorganization, and then via discussion on the list in an attempt to discover and extract which sub pages are needed for most/all microformats. | ||
Line 869: | Line 1,055: | ||
=== Microformats Proposals === | === Microformats Proposals === | ||
* rel="disclaimer": | |||
* Purpose: to create a semantic linkage (relationship) between a foot-note or end-note marker and the actual location of the text that the marker refers to. | ** Purpose: to create a semantic linkage (relationship) between a foot-note or end-note marker and the actual location of the text that the marker refers to. | ||
* rel="external": | |||
* Purpose: to formalize what is already in existence in the wild. The use of rel="external" to refer to a document that is external or outside of the current domain. | ** Purpose: to formalize what is already in existence in the wild. The use of rel="external" to refer to a document that is external or outside of the current domain. | ||
== Henri Bergius == | == Henri Bergius == | ||
Line 919: | Line 1,104: | ||
== [[User:RobManson | Rob Manson]] == | == [[User:RobManson | Rob Manson]] == | ||
* chase the admins to get some creation template extensions installed for wiki (see: | * chase the admins to get some creation template extensions installed for wiki (see: https://meta.wikimedia.org/wiki/Inputbox or https://www.mediawiki.org/wiki/Extension:CreateBox or https://www.mediawiki.org/wiki/Extension:CreateArticle) | ||
== [[User:ClayNewton | Clay Newton]] == | == [[User:ClayNewton | Clay Newton]] == | ||
Line 926: | Line 1,111: | ||
** Need examples from major ecommerce sites | ** Need examples from major ecommerce sites | ||
* Continue working on: [[trade-brainstorming]] | * Continue working on: [[trade-brainstorming]] | ||
== [[User:BenWard | Ben Ward]] == | |||
=== Recurring === | |||
* Delete Wiki Spam | |||
=== Currently === | |||
* Gardening/updating key wiki pages. | |||
** [[how-to-play]] | |||
** XHTML Design Principals | |||
* embed brainstorming | |||
* Considering new welcome banner of µf.org to link to various µf resources, rather than being dominated by the infrequently updated blog. | |||
=== Next Actions === | |||
* Conclude new hCalendar proposals from Yahoo TV Listings experience | |||
* Resume work on hListing microformat | |||
* Re-org the Microformats.org front-page content | |||
** Work with [[User:Phae]] on refreshing the microformats frontpage content | |||
** Build new events module for the blog using Upcoming.org, rather than hard coded event data (Matt Harris may have done this…) | |||
** Build new wiki edits module for the blog | |||
** Combine ‘list of microformats’ into the intro text? Make intro text more friendly. | |||
* Build a microformats activity stream | |||
** Replace front page blog with activity flow | |||
*** Wiki Edits/New Pages | |||
*** New Mailing List Threads | |||
*** Interesting µf links | |||
*** Blog posts | |||
*** Upcoming events/event reminders | |||
* Improve µf.org/blog OpenID support, find a good workflow for login/comment (current plug-in has an abysmal user experience) | |||
== [[User:Spiritquest|Ketan Majmudar]] == | |||
=== Activites === | |||
* Work on developing the [[hlisting-brainstorming|hListing]] proposal | |||
** Provide real world examples and apply this to the proposed specifications | |||
* refine and keep up to date with [[hcard|hCard]] formats as used on existing sites [[http://www.ethical-junction.org| Ethical Junction CIC]] | |||
* Understand / follow and evangalise existing patterns, especially the new [[value-class-pattern]] | |||
* see where I can help the community | |||
* look at using x2v or writing php parser classes for hcard -> vcard | |||
* open source hCard class (php) used to format db fields |
Latest revision as of 18:56, 20 November 2022
This page is for posting microformats related shared to do items. If you want to use this page for your microformats related to-do items, create a section with your name on it. The reason we are keeping these all on the same page is to make it easier to tell when people are working on similar things, and to make it more obvious when people help out with other people's tasks. In theory this probably won't scale, but let's first see how it does in practice. :) - Tantek
site homepage update
The top level home page (microformats.org) needs updating to be more welcoming to newcomers, and to highlight recent efforts & updates.
See subsections here, and search some of the older to-do items in later section for other thoughts on updating the home page (both top level and wiki, e.g. look for "homepage" and "home page" further down on this page.
why microformats
from capjamesg:
I’d love to see something like a “why microformats?” section. I know we touch on this a lot on the wiki but I’d love to see a few concise points easily accessible on the home page. Or even a “why microformats?” link in the navigation bar or something.
Perhaps a sidebar box, similar to the current "What are microformats?" section? Feel free to brainstorm here, or create a separate page to brainstorm,
- e.g. why
and then link to that as a start.
James has written a draft /why page that could get us started: https://gist.github.com/capjamesg/ee224a4d15b1212d836ca6ba92c96189
specifications
A new /why page should clearly summarize why someone who is looking at our site should consider adding microformats to a page.
We should make sure that the /why page addresses reasons that may be applicable to a broad spectrum of people, from those building personal websites to people who are here to help improve their SEO by using structured data.
accessibility
There are a few contrast errors on the home page which might make the page harder for those who are visually impaired to read.
The main issues are:
- the color of link text
- the orange headings (h2s and h3s)
- the light grey used to denote publication date and author of posts
- the "search blog" bar is missing a label
link to recent formats
from capjamesg:
I also noticed the home page doesn’t link to h-entry and a few other h- formats. I think it should
Perhaps update the "Microformat specifications" sidebar section with at least h-entry and h-feed, maybe drop rel-license, rel-tag, and XOXO (they’re not that useful on their own)? Thoughts?
- Linking to all relevant specs from the home page will help show that they are active specs. Right now one really has to know what they are looking for to come across the h-entry or h-feed specs.
more community updates
from capjamesg:
more community updates to share on the home page.
ideas or suggestions?
- capjamesg: a few people write microformats use case studies that shows how they are using them
- capjamesg: how I use microformats for my site, webmention receiver, and other projects
- capjamesg: a digest of some issues that the community is actively discussing on GitHub, perhaps with requests for help
Notes
Having more community updates would convey that there are still many active discussions going on in the microformats community. These discussions often happen in IndieWeb channels so they are less visible to someone who has just visited the microformats.org site for the first time.
microformats2 updates
The following pages need to be updated to for microformats2 (typically code, examples, and any specific format advice)
- what-are-microformats
- introduction
- get-started
- This page could potentially be consolidated with http://microformats.org/2014/03/05/getting-started-with-microformats2, currently linked at the top of the page. The get-started page has an easy to read format while the linked page on getting started with microformats2 is more detailed but less easy to skim.
- faq
- hcard-authoring -> h-card-authoring
- hcard-examples -> h-card-examples
- advocacy
- ...
wiki gardening
simplify pages
Review pages, from the Main Page on down and:
- Simplify/minimize the content in the pages with direct writing, assuming an eager(impatient,positive) reader in the primary reading flow.
- Move (keep) clarifications/details/documentation for edge case people (i.e. deliberate misinterpreters, sarcastic skeptics, pedants etc.) to details further down in a page (or on subpages) rather than in the primary reading flow.
Examples of simplified pages:
- Main Page - simplified quite a bit (2012-04-02), but could probably use additional simplification
- ...
Pages to simplify:
- how-to-play (should probably be done by an admin, but left here in case someone wants to try drafting a revision on another page and have an admin review it)
- pages listed in stable-pages (simplifying these first will help with better translations)
- for specifications, please work with their editor(s) on non-trivial content copy edits.
remove broken URLs
There's lots of links to sites that are now gone (see site-deaths on IWC for a full list).
It'd be useful if we replaced them where possible with links to archive.org or equivalent.
TODO (mark as done when done):
- Upcoming
- code.google.com
incorporate things expected to break
shortlink spec
The rel=shortlink spec:
is going to die soon as part of Google Code's shutdown.
1. We should copy that spec (along with FAQ for the first few valid questions/comments) to rel-shortlink, moving existing contents there to supplementary pages or purely historical record.
2. Get http://purl.org/net/shortlink to redirect to rel-shortlink instead.
more documentation and research
extract from 1989 timbl proposal
- extra all specific problems and use-cases mentioned in https://www.w3.org/History/1989/proposal.html
- write them up as their own wiki pages, one per specific problem/use-case
- see if they're solvable with modern microformats2
microformats specific
Just some nice things, feel free to do any of these.
for all microformats
- quick and easy "how to" pages for each microformat. get-started is a good overall start.
- brief summary statements for each microformat that explain why it matters, what does it accomplish for the publisher.
- write up mailing-list questions and answers in the appropriate faq pages.
- validators. See the hReview section below as there has been a request for an hReview validator in particular. See Norman Walsh's blog post "Validating microformats" for some valuable analysis and validation pseudo-code (prose description), which are useful steps towards building microformat validators.
- Submit definitions of "microformat", and individual examples, to the Free On-line Dictionary of Computing, acording to the Free On-line Dictionary of Computing guidelines
- it would be nice to replace the -in-the-wild pages with a form that accepted URL entries that would both register the site and look for valid microformatted content and for those pages with problems, would set them aside in a queue to be reviewed by the community. Having such an interface would likely be more efficient for implementors looking to have their work reviewed, and would also add to a ready-database of microformats in the wild -- which would be a great way to feed pingerati.com. User:Chris_Messina Chris Messina on 2007 Aug 31.
- check with the group and then, assuming this is accepted, remove mention of the profile="" attribute from the wiki, since HTML5 removes the need for profiles to be declared
hCard
- microformatted versions of conference pages
- Wait for confirmation from O'Reilly webmaster on revision of the ETel speaker's page with all the speakers marked up with hCard and links to "Add hCards to Address Book" etc., similar to the Web 2.0 speakers page which Tantek did a revision of last fall.
- vcard to hcard converter
- would be nice to have a web upload UI that would take one or more vCards from apple's address book and give them back to you as hCards
- RobertBachmann suggests starting points:
- For Ruby: http://vpim.rubyforge.org/
- For C: http://freshmeat.net/projects/libvc/
- For Python: http://www.nongnu.org/python-pdi/
- For PHP: http://pear.php.net/package/Contact_Vcard_Parse/
- I (Andy Pemberton) started working on this at one point, but haven't touched it in a while: vCard-2-hCard
- add export support for microformats to AB to Web
- A mash-up with google maps that will take any url with a hcard (or hcard's) and map the location(s) on a map (similar to austin.adactio.com)
- more test cases - add to hcard-examples to begin with, then hopefully create test cases for development to be checked in with mercurial to the repository
- include class="type" without explicit value test cases, based on hCard type with unspecified value.
hCalendar
Add support to open source calendar projects
These are open source projects that could be potentially enhanced to support hCalendar.
- WebCalendar
- PHP iCalendar
- VCalendar
- Investigation: Mozilla Calendar / Lightning / Sunbird hCalendar support discussion
hReview
- hReview support in Ecto (hey Adriaan!), requested by Andy Smith
- an hReview validator.
- a semantic, clean css star rating picker (e.g. a UI widget to rate from 1-5 stars)
hCalendar/hCard/hReview editor
- onblur in the URL field (e.g. on hCalendar), goes out and tries to retrieve an object of same time (e.g. an hCalendar vevent) from that URL and uses it to autofill the form, same thing if the creator is loaded with that URL prefilled (e.g. due to a ?url=http://example.com/ in the URL that loads the creator).
hAtom
- hatom-issues needs sections for closed issues, resolved issues, and open issues sorted by year, similar to hcard-issues.
WordPress patches for microformats
- submit patches for WordPress code/templates for microformats improvement
- <address class="vcard"> improvement in post author publication (e.g. home page of https://microformats.org/ )
- Wordpress plugin for microformats, specifically hReview and hCalendar
- See lazyweb request
Yahoo Open Source Library Patches
Several of these could very much be improved with a little microformats markup. Do we just make patches and submit them? Contact Nate Koechley at Yahoo (see Tantek for contact info) to follow-up.
Drupal patches for microformats
- Microformat Module for Drupal A group discussing ways to implement microformats in Drupal. Currently looking to support hAtom, hCard and hCalendar to start with. Contact digitalspaghetti at gmail dot com if you are interested in contributing to the project.
Adding Microformats to Existing Pages
rel-tagging on Wikipedia
Somebody familiar with the "rel-tag" microformat might want to add details, and a link to the relevant page on this Wiki, to the Wikipedia page on tagging. Andy Mabbett 14:07, 3 Jan 2007 (PST)
Glossary
Add to the glossary.
hAtom tutorial
Finish the hatom-tutorial.
wiki gardening
- Find orphaned pages, and add links to them.
- Use templates for boilerplate text and repeated lists of links
- Add keywords to the foot of pages (see vcard-suggestions for examples), so that they can be converted to tags, once this wiki allows the use of "rel" attributes. Keywords can also include synonyms to aid searching.
Spelling
Per how-to-play: for English-language pages only: Find British spellings of common words and replace them with the US spellings per en-US. Mark such edits as "minor" with the comment: [[en-US]]. Please be careful to use and maintain proper native spelling of proper nouns (see how-to-play for details).
Here is a table of searches for some of the British-English spellings that have crept into English-language microformats wiki pages, along with their respective US-English spellings. If you find other British spellings, please feel free to add them to this table, with their US equivalent.
en-GB | en-US |
---|---|
behaviour | behavior |
behaviours | behaviors |
centre | center |
colour | color |
colours | colors |
favour | favor |
flavour | flavor |
flavours | flavors |
flavoured | flavored |
minimise | minimize |
minimises | minimizes |
recognise | recognize |
recognised | recognized |
More American and British English spelling differences
Admins
This section is for folks to suggest to-do items for admins, in particular, having to do with suggestions for improvements to microformats.org infrastructure such as the wiki. If you do add an item to this list, please sign your username with four tildes: ~~~~.
Admins check this "inbox" periodically and process and move items to admin-to-do.
Please check admin-to-do to see if there is already an ongoing task item relating to your request. Otherwise add the item below.
Website Improvements
- ...
Wiki improvements
- Want: Right-to-left (RTL) support in the theme for better translating to RTL languages. Per this comment on the microformats page on Facebook 2011-02-13:
Sina Cheraghi > Microformats
"I want to contribute in Microformats wiki by translating it into Persian. But lack of RTL (right-to-left) languages (Persian, Arabic, Hebrew and ...) theme causes some problems for me and other contributors."
- Make email addresses editable Singpolyma 02:47, 26 July 2009 (UTC)
- How would this work and what's the purpose? Tantek 02:39, 10 September 2009 (UTC)
Below this section needs rethinking and triaging
All the person-specific to-do items here need rethinking in the current context of how we use and develop microformats, and current community needs.
Nearly all of the below was written before microformats2, and thus may only be applicable in a historical context, or needs to be reimagined in a microformats2 context.
How to rethink and triage the below:
- Assume that while captured in good-faith and with good intentions, nearly everything below is now obsolete and/or the person who added it under their name has gone on to do other things.
- Feel free to use the below for inspiration for what things could be done, and copy & rewrite them in a modern context in the previous (above) non-person-specific sections (to make it clear that anyone is welcome to help work on them).
- Maybe after a person’s previous to-do items have all been rethought/triaged into modern to-do items above, their section can be moved to an "Emeritus" subsection down at the bottom
- Emeritus subsection to be created.
Thoughts?
- Tantek: I'm ok with the items listed under my name being *cut* and pasted (with modern updates) incrementally into the above sections, no need to preserve them after they've been rethought.
- Please keep them around until they have been rethought
- Ideally do the cut and paste in the same edit so it's clear where something moved in the wiki-edit-diff.
- ...
---
Tantek
I'm keeping microformats related to-do items here both for my own convenience, and for folks looking to help out. - Tantek.
overall priority ordering
- Protect the community from threats (wiki damage, mailing list pain or noise), repair damage, add measures to reduce future damage
- Update microformats2-parsing with resolved microformats2-parsing-issues
- Help implementers with established microformats
- Iterate on existing established microformats, resolve issues/feedback etc.
- Wiki cleanup/gardening for existing established microformats
- Site usability of microformats.org top-down as an entry point
- Community dynamics, process and principles improvements to help guide new microformats developments
- Wrap up classic microformats documentation
- Document microformats history.
- Other
protect the community
- Analyze Special:Recentchanges and mailing-lists and:
- add to mailing-lists and how-to-play policies/guidelines accordingly.
- redirect and resolve threads accordingly per guidelines
- privately email violaters kindly asking them to improve their behavior
- work with admins on next steps for individuals negatively impacting the community
- recognize noisy/distracting threads on the email list, document responses/answers to such subjects on the appropriate page(s) on the wiki, and reply to those threads with the URLs to the documentation on the wiki. Putting the responses/answers on the wiki helps by hopefully providing preemptive answers to some who might reraise the subjects on the list in the future, and helps the community quickly terminate such threads by using the answers on the wiki.
- move exploratory discussions which are failing to follow the process to a separate page from that
- repair damage done to the wiki
- identify damage done to the wiki - often in forms as simple as content changes that hurt usability (and thus accessibility)
- document additional how-to-play guidelines to discourage and hopefully reduce such wiki damaging behavior in the future
- repair/undo/reorganize page section division that hurt usability (and thus accessibility)
- hcalendar-examples-in-wild
- afterwards add some of the excellent conference schedule calendars that User:Adactio has been creating like:
- hcalendar-examples-in-wild
- repair/undo/reorganize page splitting that hurt usability (and thus accessibility)
update microformats2-parsing with resolved issues
Update microformats2-parsing with resolved microformats2-parsing-issues
help implementers
Update all these tasks for microformats2:
- wordpress improvements
- WP admin for new profiles
- should simply read blog URL - next-action: make sure a bug/feature request is filed with wordpress.org
- look for hCards and parse them
- WP admin for new profiles
- XFN Creator localizations
- Get someone to verify the XFN Creator Russian localization.
- Add it to the XFN Tools page.
- Add rel="alternate" href="creator-ru" <link>s to the other XFN Creators.
- Conference Schedule Creator
- next-actions: Review Dmitry Baranovskiy's Conference Schedule Creator and give him feedback per how well it:
- Makes it *trivial* for conference organizers to build/edit/publish an hCalendar schedule for their conference, including auto-generated "Subscribe..." link which produces the proper "webcal:..." link with X2V. Note: see the "axis" and "header" attributes in HTML4, specifically in the section on Tables.
- next-actions: Review Dmitry Baranovskiy's Conference Schedule Creator and give him feedback per how well it:
wiki cleanup
Update all these tasks for microformats2:
for all microformat specs
Next-actions:
- modularize any specs which are > 30K in order to avoid loss/corruption like Evan's 14 June edits to hCard, rel-tag, and XOXO.
- hCard -
- hcard-examples-in-the-wild group/sort by individuals, organizations, and hosting sites. Consider moving largest subsection to its own page as well.
- rel-tag
- xoxo
- hCard -
update specification section organization
Goal: greater approachability/readability of microformats specs by a broader audience.
Reference:
- hResume has an experimental abbreviated intro/headers section, and links to more details further below, based on some ideas that Ryan King and I had for improving the readability of the microformats specifications.
- hReview has some similar improvements, but different.
- hCard has numerous improvements as well, again different from either hResume or hReview
Next-actions:
- contact microformats community members who are content/tutorial authors, and/or have written (or are writing) technical books, and those who have made concrete helpful suggestions for reorganizing the information architecture / content-order / layout of specs.
- figure out if the new intro/headers etc. structure/order in hCard, hReview, and hResume is an improvement, and if it could be better. Document reasoning/requirements for intro/header and other sections.
- Shorter tends to be better
- Must be comprehensive enough to "print and read"
- Must detail authorship/editorship
- Must detail copyright/patent statements
- Design an iterative update to spec organization, in particular, the introduction/boilerplate/headers.
- Write up a template - make it self-documenting per the requirements
- Update existing specifications with the new intro/headers structure.
- Write up methodology behind the section organization and note editors lessons learned into an editors-guide page (what other variants were done before, in which specs, and note problems/complaints with other variants).
reorganizing Implementations sections
- sort implementations by authoring/creating/publishing, browsing/viewing, converting/importing, indexing/searching.
Hmmm... I like: Authoring, Browsing, Converting, Indexing, Libraries (for developers), and Potential (for open source projects we want to add support to). Anybody have alternative suggestions for this vocabulary? I don't have a particularly strong preference so I'm going to go with these four until I find examples that don't fit, or someone suggests something better.
See: hCalendar Implementations for a first attempt at this. Assuming folks like that, we can go ahead with categorizing the implementations sections of other microformats specifications.
Next-actions:
- hcard-implementations - re-organize by same subsections as hcalendar-implementations.
- hreview-implementations - re-organize by same subsections as hcalendar-implementations.
- hatom-implementations - re-organize by same subsections as hcalendar-implementations.
- xfolk-implementations - re-organize by same subsections as hcalendar-implementations.
reorg Examples in the Wild sections
Work with community to:
- include more *key* details per example, e.g. precise or estimates of counts for services
- collate/sort examples in the wild by
- hosting services - where users/people actively contribute to the growth (e.g. Flickr profile hCards)
- publishing services - where lots of data is published from some datasource/database (e.g. Yahoo! Local)
- companies/groups/organizations member pages (and their own) - pages for a group's site where they list members or employees (e.g. Technorati staff page)
- individiual companies/organizations contact info pages
- individual people's contact info pages
- of course at some point this won't scale, but that will be a very good problem to have, and by then I'm sure we'll have services to point to that provide queries and search results for all this data.
site usability
Update all these tasks for microformats2:
- figure out how to get wordpress to autopost blog posts to the microformats-announce list
- ideally use the from address of the author of the blog post
- maybe photomatt knows how to do this.
introduction / community
Update all these tasks for microformats2:
- microformats-discuss *
- introductory email template for new subscribers needs to direct people to process and how-to-play
- Need to add more to the naming-principles, to cover in particular:
- avoid using the same name to mean two things
- avoid using two names to mean the same thing
- seek to keep the microformats vocabulary minimal, memorable, and usable.
- update and add details/simplifications to process given the past several months of experience. in particular:
- clarify requirement (MUST rather than SHOULD) of *-examples, *-formats, before any *-brainstorming.
- Add details of encouragement to experiment with simple semantic class names from *-brainstorming proposals to gain real world experience with real world content.
- note SHOULD prerequisite of use of all relevant microformats on real world web pages, along with documenting such use in respective "Examples in the Wild" sections, before proposing any new microformats.
posh improvement
- Create a page to answer the question "how-should-i-markup"
- consider creating a process/encouragement for collecting individual posh practices and examples, like a folksonomy of semantic HTML and semantic class names.
principles and process
Create the following pages and document/fill them with content from other pages, email lists, and presentations.
- principles - mostly documented in the microformats page.
- clearer statement of both copyright and patents both in specific specs and in general
- resolve process-issues
profiles
- update XMDP with new required features:
- ability for one profile to include/import another (rel="import" ?)
- ability to reference an XMDP via rel="profile" (similar to XHTML2 rel value by same name)
- add rel="profile" to the xmdp-profile.
- ability/suggestion to reference an XMDP using <a href> in addition to <link>
community mark
- Can we make "microformat" and "microformats" into Community Marks?
document issue resolutions
- Prefixing has already been considered and rejected for microformats in general. Note naming-conventions, limited vocabulary, and exceptions made for hAtom and how we went about doing so.
emerging microformats
Update all these tasks for microformats2:
Next-actions for each emerging microformat (one at a time)
- review all microformats-email on the new microformat
- determine where new microformats is "stuck" in the process
- brainstorm about how to improve process (or documentation thereof) to get the effort unstuck
- work with community to move the microformat forward through the process, iterating/clarifying the process as necessary
new microformat requests
Update all these tasks for microformats2:
- expense reports (really just a list of "expense" items), requested by ED, should look at UBL as a pre-existing format
- photo-notes microformat
- clean up Subethaedit notes from working session with Greg Elin, Ryan King, Kevin Marks, Suw Charman and email to folks and figure out next steps
- iterate on photo-note-examples and start photo-note-formats and photo-note-brainstorming.
wrap up classic microformats documentation
- use these tasks to come up with any necessary or useful equivalents for microformats2 specifications and resources.
minor update current specifications
- draft hCard 1.0.1: hCard spec next-actions:
resolve remaining hCard issues- close remaining hCard resolved issues by writing necessary FAQ entries, updating hCard, and adding to hcard-brainstorming for 1.0.1 and 1.1.
- draft hcard-1-0-1 by starting with hcard-1-0 and incorporating hcard-brainstorming targeted for 1.0.1.
- incorporate hcard-feedback
- continue updating the spec per the inline comment about property references
- add a brief descriptive sentence for each property, similar to what hReview has. just enough so that the casual reader can avoid having to reference and read the respective sections in RFC2426. add any non-trivial information about each property similar to what hReview has.
- iterate hcard-parsing with value-class-pattern as a required feature
- iterate hcard-parsing with sufficient table element special handling to do people equivalent of brainstorming#Tabular_event_calendars
- iterate hcard-parsing with how to handle new or different HTML5 markup such as the
<time>
element, including at least one test case with the<time>
element. - hcard-brainstorming next-actions: determine which brainstorms proposals to resolve for minor revision, and which later
- Update semantic-xhtml with lists of semantic elements and attributes.
- Update hcard-brainstorming on element specific parsing rules
- Update X2V, hKit, Operator accordingly
- Write test cases accordingly
- Update hcard-parsing accordingly
- draft hCalendar 1.0.1: hCalendar spec next-actions:
resolve all outstanding hcalendar-issues into hcalendar-issues-resolved- close remaining hCalendar resolved issues by writing necessary FAQ entries, updating hCalendar, and adding to hcalendar-brainstorming for 1.0.1 and 1.1.
- draft hcalendar-1-0-1 by starting with hcalendar-1-0 and incrementally incorporating hcalendar-brainstorming targeted for 1.0.1
- incorporate hcalendar-feedback
- itemize a complete property list similar to the hCard property list, drawing upon hCalendar experience, iCal-BASIC draft(s), ietf-calsify mailing list and other sources to derive the precise list. Separate common properties up front.
- add a brief descriptive sentence for each property, similar to what hReview has. just enough so that the casual reader can avoid having to reference and read the respective sections in RFC2445. add any non-trivial information about each property similar to what hReview has.
- significantly update and thoroughly specify hcalendar-parsing with value-class-pattern as a required feature
- formally document brainstorming#Tabular_event_calendars
- iterate hcalendar-parsing with how to handle new or different HTML5 markup such as the
<time>
element, including at least one test case with the<time>
element. - hcalendar-examples
- make sure all hCalendar examples that reference whole days use best international/accessible date format of YYYY-MM-DD
- add explicit explanation and examples for LOCATION hCards and ATTENDEE hCards, perhaps on a separate hcalendar-examples page.
- Write compound-parsing by abstracting commonalities between hcard-parsing and hcalendar-parsing.
- draft hReview 0.4
- resolve hAtom issues
- co-edit hAtom per permission from David Janes
- draft hAtom 0.2
- Clarify that "published" property values may omit seconds, and that converters to Atom are expected to imply ":00" seconds.
- add sections for comments/opinion from community as well as issues subsection
- solicit feedback
- when sufficient consensus and issue resolution achieved, archive previous versions of specs, and update spec pages accordingly.
social network portability
Iterate on:
Brainstorm updates to the pocket-cheat-sheet to better enable social-network-portability, or perhaps design a new social network portability pocket cheat sheet that specifically documents:
- how to author/publish hCard user profiles - write this up in hcard-authoring first (see below) and then use that content.
- how to author/publish hCard+XFN friends lists - write this up in hcard-xfn-authoring (see below) and then use that content.
- how to parse/subscribe to hCard user profiles - write this up by updating: hcard-parsing, and writing hcard-supporting-user-profile-parsing (collect this into parsing/developers tasks below)
- how to parse/subscribe to hCard+XFN friends lists - write this up by writing: xfn-parsing, hcard-xfn-supporting-friends-list-parsing (collect these into parsing/developers tasks below)
- notes/thoughts on hCard+XFN supporting friends list parsing captured here for now:
- do a full rel="me" bidirectional crawling within the domain - some sites' hCard supporting user profiles simply link to their hCard+XFN supporting friends lists with rel="me", and thus you will discover more pages with friends lists.
- E.g. Flickr's /people/username pages have hCard for the user and link to their /people/username/contacts page with rel="me" (on the "More..." link, though they could also add rel="me" to the number inside "Your contacts (592)"). Need to get them to support hCard+XFN on the contacts themselves.
- consider parsing within a friends list page, any links that are rel="next" and rel="prev" to iterate over the whole list.
- do a full rel="me" bidirectional crawling within the domain - some sites' hCard supporting user profiles simply link to their hCard+XFN supporting friends lists with rel="me", and thus you will discover more pages with friends lists.
- notes/thoughts on hCard+XFN supporting friends list parsing captured here for now:
foldup cheatsheet
next actions:
- gather feedback on current foldup pocket cheatsheet
- document the feedback on the pocket cheatsheet
- provide printing recommendations for anyone to download and print their own
- update cheatsheet to include new value-class-pattern uses
- give feedback to Erin or ask for volunteers to create a new cheatsheet, iterate, print more to have on hand, fold, distribute.
- discuss with User:Adactio and Hannah how to best create a UK/A4 version of the pocket cheatsheet
- preferably well in advance of dConstruct 2008 so that local cheatsheets can be printed.
*-authoring microformats wiki pages
- hcard-authoring - next-actions: add tips/instructions noted below.
- instructions for each property that is in hCard creator to begin with
- instructions for all other hCard properties
- a tutorial on creating an hCard for your site
- specific instructions for common blogging platforms
- reference hcard-examples for more specific uses, and add to them accordingly
- add an extended example to contact info for a page with postal address, phone numbers, email address.
- hcard-xfn-authoring - next-action: draft by starting from hCard+XFN instructions in hcard-examples.
- hreview-authoring - next-action: create a first draft minimal tutorial on how to author hReviews (e.g. at least for common properties) to blog reviews so that they'll be aggregated.
- hcalendar-authoring - next-action: add tips/instructions for each property that is in hCalendar creator.
- *-authoring for other reasonably well established microformats:
help with microformat examples in the wild
Using the above updated authoring pages, get the community to help go over all "common" pages (both logged out and logged in states) of the following sites which have some microformats already, and verify each page is as microformatted as it can be with high fidelity hCalendar and hCard etc. Document full support of each implementation's microformats on the implementations page (perhaps create a separate page for each implementation, e.g. flickr, upcoming, eventful etc.) Document any exceptions as needed. In no particular order:
- Flickr.com (3.5m hCards)
- Upcoming.org (100k hCalendar events, 100k hCard venues)
- home page
- Eventful.com (100k hCalendar events, 100k hCard venues)
- Yahoo! Tech (300k products with hReviews)
- JudysBook.com (???k hReviews)
- ... lots more, get from "Implementations" and "Examples in the Wild" sections of specs.
advocacy for obvious sites
- advocacy - add pages/sites that obviously (no pun intended) could use microformats, update them with sample markup, find contacts for those pages to get them updated, and send requests to update their sites with microformats including sample markup. next-actions: markup both twitter.com sample pages and dodgeball.com sample pages, post the changes publicly, and see which one is able to update first ;)
- dodgeball.com (hCard + XFN + hAtom for profiles, hCard + hReview for venues)
- write essay on open-data-more-important-than-open-source - and a shorthand URL too.
- obviously doing both is ideal, however, open data is a higher priority and given limited resources, open data should be implemented before open source.
- open data > open source
- "open information" vs "open source"
- i.e. please focus first on open data rather than open source, e.g. start with hCards for all organizations returned from http://wiserearth.org/organization
- if the data is open you can always export it and consume it in any number of open source systems
- that's why open data is MUCH more important than open source
- adding open data (e.g. microformats) can be done by any HTML author (yes, you), whereas open sourcing requires programming expertise, resouces, support. do the simpler easier thing first (open data thru microformats) that will benefit more people sooner.
- if the data was open, anyone could rebuild an accessible version
- faqs / misconceptions:
- eschipul: @tantek - creating microformats is easier. consuming microformats is unfortunately not easier.
- A: If you think consuming microformats is not easier or hard etc., it may just be that you don't know how to do so easily, don't assume that you are an expert in something that you think is hard. Rather, if you think something is hard, then assume others may know easier methods, and ask the community how one can do it more easily. parsing in particular is something which is becoming easier and easier thanks to open source libraries like hKit.
- eschipul: @tantek - creating microformats is easier. consuming microformats is unfortunately not easier.
- write essay on open-data-more-important-than-open-apis - and a shorthand URL too
- obviously doing both is ideal, however, open data is a higher priority and given limited resources, open data should be implemented before open APIs.
- publishing/providing open data (e.g. microformats) can be done by any HTML author (yes, you), whereas providing/publishing open APIs requires programming expertise, resouces, and support. do the simpler easier thing first (open data thru microformats) that will benefit more people sooner.
in general
plain language intros
For hCard, hCalendar, hReview, XOXO to start with, write up:
- brief plain-language intro at the top (say for example, something that a non-technical person like a member of the general media/press could read and understand), similar to or better than plain language intros on W3C specs.
- followed by links to more plain-language resources, e.g. *-intro pages.
In particular for XOXO, Angus McIntyre suggested:
- As well as a syntactic example, examples of use would be useful.
- when I might want to use XOXO.
- Some simple examples right upfront would probably do a lot to help users figure out whether a particular microformat is for them or not.
These suggestions could be incorporated into the other specs as well.
exploratory discussions
- update exploratory-discussions with critical microformats as "active"
CSS enhancements for
Analyze existing microformats for opportunities to enhance CSS and propose to W3C.
- e.g. CSS datetime presentation (need to add links to my earlier work in CSS working group)
- brainstorm additional possibilities for better presentation of content using existing microformats.
update affiliations
- Start a minimal draft/spec style guide using outline of most readable/accessible spec so far
- Reference https://www.w3.org/2001/06/manual/#Editors for how to manage affiliations
- Update affiliations on hcard, hcalendar, hreview, etc. per https://www.w3.org/2001/06/manual/#Editors
profile URLs
- write-up and document profile URLs for all established microformats and perhaps for some drafts as well
hCard
Combined next-actions for iteration on hCard, and derived/subsetted microformats adr and geo
- hcard-profile next-actions:
- update property definitions with more detail using semantics from RFC2426
- link from brief sentence descriptions for each property in hCard to the respective more detailed definition in the hcard-profile.
- link from definitions in the hcard-profile to the specific sections in the vCard spec
- hcard-examples next-actions: update with examples described below
- add examples of hCards with work telephone, mailing address etc.
- add examples of marking up an organization vs. a person, then link to it from hCard spec section on Organization Contact Info.
- add example of organization-name and organization-unit usage.
- hcard-brainstorming next-actions: explore brainstorms proposals for a 1.1 revision, e.g.
- need property for gender (see proposal in hCard FAQ and discussion in hcard-issues) - use tags for now, add to hCard creator
- solve autodiscovery of more canonical/thorough hCard
- hcard-examples-in-wild
- help dglazkov markup: http://glazkov.com/blog/archive/2003/12/17/147.aspx
- analyze hcard-cheatsheet, adr-cheatsheet, geo-cheatsheet for any assertions above and beyond what the specification itself says, take into account hcard-brainstorming along similar lines, and incorporate into the spec or remove as necessary and sync-up as a result. add clarification on the cheatsheets that they are informative and reference the specification for normative requirements.
hCalendar
Next-actions:
- update hcalendar-examples
- add examples like hcard-examples
- flesh out and do a once over on markup/presentation of what RFC2445 examples would look like
- update all hcalendar-examples to use value-title from value-class-pattern where abbr doesn't make sense. e.g.
- rrule
- duration
- ... etc.
- need spec details and then hcalendar-examples of multi-instance hCalendar events
- need spec details and then hcalendar-examples of repeating events
- have folks verify hcalendar-profile. Note that it will likely need reconciliation with the hcard-profile, especially since hCalendar normatively depends on hCard. Probably makes sense to have a combined profile which hCalendar would use.
- analyze hcalendar-cheatsheet for any assertions above and beyond what the specification itself says, take into account hcalendar-brainstorming along similar lines, and incorporate into the spec or remove as necessary and sync-up as a result. add clarification on the cheatsheets that they are informative and reference the specification for normative requirements.
hReview
Next-actions:
- reconcile hReview 0.4 XMDP profile with hcalendar-profile and hcard-profile. Makes sense to have a combined profile of all three for hReview, since hReview normatively depends on hCard and hCalendar.
- Resolve all outstanding hreview-issues and hreview-feedback to-do items.
rel-tag
Next-actions:
- send rel-tag XMDP profile (rel-tag-profile) to David Baron.
- Resolve all outstanding rel-tag-issues and rel-tag-feedback to-do items.
rel-me
Next-actions:
- move XFN and XMDP FAQs, tutorial, descriptions, spec etc. from gmpg.org to microformats.org
- and put redirects in place, notes about contribution
- update rel-me examples and document with examples the rel-me implict subdir rule
hAtom
Next-actions:
summary Examples in the Wild page
- need to create a summary / overall examples-in-the-wild page
- parallel the summary/overall implementations page.
- use newly reorganized content from the above "reoganizing Examples in the Wild" task
parsing
Next-actions:
- Draft *-parsing for all reasonably well adopted microformats: hreview-parsing, xfolk-parsing, hatom-parsing
document microformats history
Document microformats history, including:
- dates and origins of microformats, names, terms
- examples and formats for established microformats like hCard, hCalendar, xfn, rel-license, xoxo
other
- Add XPath equivalents where appropriate in hcard-parsing
Ryan
wiki cleanup
possibly move dead proposals off of homepage?
hCalendar/hCard/hReview creator improvements
- get all creators working in IE/Win, IE/Mac, Safari/OSX.3
other
- add an example of how to use DURATION in hcalendar see http://www.policyawareweb.org/2005/ftf2/paw-mtg#item15) -> verify http://svn.lifelint.com/hcalendar_tests/calendar-todo-multiple-attendees-and-alarm.xml
rel-payment
- update rel-payment to reference the IANA registry [1]
hcalendar
- make sure we explicitly disallow 'vjournal'
Dimitri Glazkov
- Figure out REST/Microformats thing
- Work on result set idea
- Implement h-creators using Web Forms 2.0
Chris Messina
General
- Work on a microformat for play-lists (is it just a XOXO ordererd list of play-items?)
- Work on a microformat for play-item (take a look at media-info-examples)
- Work on microformats tutorial for designers
- Add support for OpenID to micformats wiki
Add support for OpenID to the microformats blog.Read GTD (at least the first two chapters).
Campaigns
Get Blogger to support hAtom and hCardGet LinkedIn to support hCard, hResume, hCalendarand XFN- Get XING to support
hCard, hCalendar, hResume and XFN - Get
Digg to support microformats(still need XFN).
Wishlist
- Microformat for "buyable items" (see listing-examples and related documents)
- Location MF -- right click "map this" (see geo and adr)
- Better hCard support in the browser -- right click "IM this person...", "Add to contacts" (see Flocktails)
- Better hCal support -- support many views of same hCal data on one page using XSLT
- We need something that a designer/web programmer can come to and leave w/ 2 examples of each microformat that they can apply right away... a "microformats styleguide for designers", if you will.
- invoicing microformat
- better microformats wiki theme
- Define flow for OpenID + XFN + hcard (see DiSo Project)
Hey Chris. Congrats on Microsyntax ("Stowe Boyd launches Microsyntax.org"). So ... do we need a page on this Microformats wiki describing the connection between microformats and microsyntax?
Robert Bachmann
XSLTs
- Test scripts
- Do some refactoring, split Perl code into smaller modules
- Provide test results as HTML pages (similar to https://www.w3.org/2003/08/owl-systems/test-results-out)
- Provide some documentation for using the test scripts
- hAtom2Atom
- Join all hfeed's inside a page (or a fragment thereof) into one feed using atom:source semantics.
-
Extraction of
atom:content
,atom:summary
andatom:title
:atom:content
andatom:summary
as HTMLatom:content
andatom:summary
as plain-textatom:title
as XHTMLatom:title
as HTML
- Support for other XSLT engines:
- .Net System.Xml
- hAtom2Atom written using XSL 2.0?
- Do you think this would be useful? I have created a barebones version, doesn't yet take in all the parsing rules yet, but I'd be happy to share. Moving to XSL 2.0 does make things a bit cleaner and more efficient. - Matt Dertinger.
- Support for other output formats: (hAtom2xyz.xsl)
- RSS 2.0 (meanwhile use hAtom2Atom.xsl and atom2rss.xsl) -- +1 Matt Dertinger
- RSS 1.0 (meanwhile use hAtom2Atom.xsl and atom2rss.xslt) -- +1 Matt Dertinger
- My opinion at the moment, I neither want to produce nor to consume RSS. Atom is nicer (and should be supported by most good feed readers available today), RSS should fade away. -- Robert Bachmann
- AtomOWL (meanwhile use hAtom2Atom.xsl and atom2rdfxml.xsl)-- +1 Matt Dertinger
- Having the possibility of GRDDL-ing hAtom to AtomOWL seems definitly interessting. I realy should implement this some day. - Robert Bachmann
- JSON?
- Does it make sense to consider a canonical representation of microformats (either case by case, or in general) in JSON? E.g. so that a JSON API that returned contact information could return an hCard-equivalent chunk of JSON. - Tantek.
- This could enable some nice JavaScript hacks. I should give hAtom2JSON a try. - Robert Bachmann
- Does it make sense to consider a canonical representation of microformats (either case by case, or in general) in JSON? E.g. so that a JSON API that returned contact information could return an hCard-equivalent chunk of JSON. - Tantek.
(singpolyma 01:02, 9 May 2006 (PDT) -- Not XSLT, but see http://xoxotools.ning.com/hatom2rss.php for hatom to RSS2.0 conversion)
Brian Suda
Citation Microformats
- Add all my notes to the Wiki
- Start the process of naming the properties using existing names
X2V
Make changes and update site (almost stable) Get ATTENDEE and other strange attributes working
WARNINGS and ERROR
work on the warnings and error output for the pre-check in X2V
FAQ
- clean-up the MF FAQs
- clean-up FAQs from the major microformats
- pull Questions from the mailing list and document them to the FAQs and example
Microformats History
- get early work from developer.technorati site
- issues with MoinMoin full history: http://moinmoin.wikiwikiweb.de/MoinMoinQuestions/UsingTheWiki#head-9d1b1d6beedde40b92cc6c13962b5a6f5b289d10
additions to the wiki
- better explain why NOT infinitely scaling is a good thing
- better explain why microformats do NOT use namespacing
Mark Rickerby
Current Tasks
- Follow up on usability review
- Edits to homepage feature box text
- Draft of getting-started page
- Review content for new pages - start-simple, modularity, reuse, humans-first
- xoxo datatype examples
- test case lists
- transmitting key/value lists
- practical feedback on hresume
Wishlist
- hmmm
Ernest Prabhakar
Wiki-Thon Proposal
Set aside several hours (probably a Friday night US PST) for focused work on the Wiki, including both physical (e.g., a room in the Bay Area) and virtual (IRC/iChat) participants.
Goals
- Improve understanding of what needs to be done for Wiki
- IMHO - this should be done here, in to-do incrementally. -Tantek
- Tackle larger projects (~1-2 hours) than people usually have time for
- I'd like to see these projects *documented* first on to-do before we spend 1-2 hours of a bunch of folk's collective time to go through them. -Tantek
- Motivate community to have fun with otherwise tedious "housecleaning" chores
Agenda (Wishlist)
In parallel:
- Coalesce/prioritize existing To-Do items (above)
- Review/revise desired pathways for:
- New users learning about microformats
- e.g., intro, about, explore, tutorials, etc.
- cf. Rails front page
- Get Excited (Why, background, motivation)
- Get Started (What, downloads, getting started)
- Get Better (How, tutorials, )
- Get Involved (Who)
- Microformat lifecycle
- e.g., research->brainstorm->proposal->spec->maintain
- see http://theryanking.com/microformats/method.txt --RyanKing 15:35, 22 Feb 2006 (PST)
- ensure information easy to find, follow, and up-to-date
- New users learning about microformats
- Review existing specs for completeness and consistency
- Identify areas of 'bitrot' or 'hole-filling'
- Do it!
Dan Connolly
DanC hopes to sync up on these tasks in irc roughly weekly, during Wednesday afternoon (Chicago time) "office hours". See also my esw todo list and someday pile.
- from SxSW in Austin
- build a combined hcalendar/hcard profile; resolve issues in profile-uris.
- with XSLT transformation to RDF
- finish hcard-tests
- figure out include-pattern boundaries
- build a combined hcalendar/hcard profile; resolve issues in profile-uris.
- Medium term
- sync hcalendar-tests and RDF calendar tests and CALSIFY
- reconsider RDF calendar naming conventions
- update my CV/resume using hResume and citation-formats
- get an answer from the CALSIFY WG re dtstart and date vs datetime 21 Apr 2006
- refine hatom so that it's suitable for the workflow around the W3C homepage.
- sync hcalendar-tests and RDF calendar tests and CALSIFY
- from WWW2006
- follow up on GRDDL as escape valve for microformats proposals, much like CSS was an escape valve for HTML tag proposals.
- Someday pile
- set up a timezone registry based on wikipedia and semantic mediawiki. As discussed in datetime-design-pattern, iCalendar's by-value timezone passing is broken. see reconsidering timezones in light of hCalendar and CALSIFY and Toward Semantic Web data from Wikipedia
- noodle on a playlist format and some of the media RSS stuff like media-info-brainstorming, media-metadata-examples (re playlists: XSPF, SMIL, RDF, and microformats 9 Sep 2005)
- check out that hReview bug stuff...
- noodle on meeting-minutes-brainstorming and MeetingRecords in the esw wiki.
- noodle on clipboard scenarios, esp how RDFa works in the general case but isn't as author-friendly as domain-specific syntaxes.
DanC 15:39, 31 May 2006 (PDT)
Chris Casciano
- get around to updating hatom-issues with some multi feed rules/exceptions.
Update textpattern plugin with simple hreview support and get a new release out- Redesign placenamehere.com and include hatom
- Follow up with technorati folks on pingerati reviews getting lost (note: this will require publishing more reviews and theen watching them through the update process)
prototype a NetNewsWire microformat extractor (CSS+AppleScript)
Drew McLellan
- Build an hReview profile for hKit and test
- Update the Dreamweaver extensions to mirror recent changes in the online builders
Publish an hCard to JSON service on tools.microformatic.com using hKit.- Further develop blog comment form hCard collection ideas.
- Version of hReview creator using hKit to import business details from an hCard
Christophe Ducamp (french localization)
- seed "microformateurs group" and invite them to update https://microformateurs.org
- translating the wiki
- translate red links on Main_Page-fr and synchronize
- find out microformateurs at ease on "the-wiki-way-translation", and ready to help on semi-anonymous-synchro
- community-marketing -> pinko-marketing
- public-relations towards french journalists and complete advocacy (especially hcard-advocacy-fr towards organizations.
- help to build events, workshops like barcamps and explorcamps
- update French-wikipedia:Microformats and subpages via cowriting on discussion page (directly originated from the english article) + french examples to be found + local resources.
- open discussion with french wikipediens about implementing some of the english existing templates
- small gifts: accessories and free gifts ? t-shirts, localized cheat-sheet, id-hcard-openid-providing, etc.
- create hCard, hCalendar... and all red link pages on french wikipedia
- localize species-fr and related pages
- move all contents remaining on elanceur.org -> microformateurs.org
- wiki and uf:
- write and talk with "aboutus.org" to invite them to make experiences with uf -> talk with Mark Dilley
- maintain/update http://www.communitywiki.org/MicroFormats and talk with LionKimbro
- XWiki : awaiting beta-test of new platform
- Follow-up LudovicDubost et LaurentLunati
- setup real-life links with european governance members ;) may be joining dconstruct-microformats-workshop - find solution (registering fees and travel expenses -> talk with Arnaud Fontaine or search french sponsors)
Frances Berriman
- Clean up this todo list (meta!)
- Move alumni admin tasks out, and into a 'up for grabs' bucket (unless 100% specific to person).
- Ping anyone with specific tasks / nag
- Move alumni admin tasks out, and into a 'up for grabs' bucket (unless 100% specific to person).
- Proposal for page simplifications - notes, to expand to tasks later:
- Need a way to push active formats (those in the process) to the fore, and push back stagnating items.
- Process updates to blog?
- Activity overview updates on main site somewhere?
- Code and Tools page on site: Currently it's mostly only tools. Need to add a list of actual specifications on the wiki.
- In general: less clutter, more structure, more focus.
Ben West (bewest)
- fight spam
- help tend wiki
- documentation of semantic authoring techniques
- researching the social problems relating to authorship and publishing on the web
- development of new microformats in response to failing to meet the needs of the second with the first.
Expore Microformat Deployment Issues
How does who determine the status of work going through some stage of the process? When does a format move from draft to "full spec"? Who decides? What are the qualitative and quantitative features that characterize work in different stages, especially as a spec nears deployment as "full spec". What makes this pronouncement more than a mythical blessing? What quantitative analyses can be provided to validate deployment? Today, we have powerful agents capable of processing huge amounts of information on the web. Should we be using these to measure published marketshare? What role should tools and test suites play in deploying microformats?
Vocabulary
A lot of knowledge work is about maintaining sets of vocabulary. Now that the vocabulary is emerging, it may be time start making sure everyone is "on the same page," especially since some of the language is highly symbolic. Terms:
- "boil the ocean" A huge task. "A phrase used in the industry to describe an attempt at something that is way too ambitious. For example, "They're trying to get their site launched by COMDEX. They could easier boil the ocean." from <http://www.netlingo.com/right.cfm?term=boil%20the%20ocean>
- microformats: more than one microformat
- microformat: see my definition on https://microformats.org/wiki/what-are-microformats#BenWest
- data fidelity: the extent to which a data format might be considered lossy. eg HTML is often seen as a lossy format because the information parsed out of a resource may not fully match the information orginally encoded. Non-lossy formats have a very high data fidelity, while lossy formats have low data fidelity. Microformats seek to increase data fidelity of html.
- market: the locus of economic forces
- See glossary. Andy Mabbett 13:57, 7 Dec 2006 (PST)
Creators
_Concession_: my plans involve reuse of code, which would involve non-compatible changes with the current inline model. This is a nice feature, so maybe I should be branching instead.
Start hatom creator.http://dichotomize.com/uf/hatom/creator.html- Code Reuse. These creators are downright handy, and I’ve reimplemented the vcard one on my own site. Instead, let’s make these widgetized. Let’s decide on a more or less canonical html structure and create some javascript that will create the desired microformat. Something as easy to use as new Microformat.hCard($('mycontainer')); would be awesome. Right now, if someone makes an improvement to the hCard creator, the other creators don’t get the benefit. Spec this out!
- About Section. Is there an official creator page? If so, let’s point to that. The about paragraph is getting longer and longer with phrases like “which is based on…” repeated over and over.
- Default all dates to “right now”. Provide an easy to use calendar type widget to change dates.
- hAtom creator: Add multiple. It’d be nice to add an arbitrary number of entries.
- hAtom creator: Optional feed enclosure. Check box to wrap the entry/entries in an hfeed.
- Edit URI: Allow someone to enter a URI and edit whatever microformat is found on the page.
- Optionals. If the format requires, say, a vcard, the creator can defer to an external URI or can trust the user to fill it in later.
- Common stylesheet. I suppose this goes with the reuseable code idea… we have many great coders, we should be reusing eachothers’ work.
- Use Amazon's ECS to pull in information about products when there is an ASIN in the item URI.
Information Architecture
Help Welcomed! Please leave your name Add complaints to wiki-feedback! Helping to make the wiki easier to use. I'd like to see the main page more towards a format like http://simile.mit.edu/solvent/ with the big questions right out front:
- What Is This?
- What can I do here?
- Is there a demo?
- Where can I learn more?
I'd like to change the front page to this kind of design.
Support Pages
There are several categories of things in the wiki. Can we enumerate them?
- About the Community
- Where to find information.
- Who are the stake holders?
- FAQs
- Web/Architectural Philosophy
- Community Principles
- Why are we doing this?
- XML and Namespaces
- Semantic XHTML
- Common Misconceptions
- Concession and Disposition of Criticism
- FAQs
- Specs
- Examples
- Discussion
- Exploration
- Use Cases
- Implementations
- The spec itself.
- Tips and Tricks for Authoring (BenWest 15:00, 9 Dec 2006 (PST))
- how to author semantic html
- choosing class names
- using HTML's general extension mechanisms
- advocating use
- collaborating/reusing HTML
- debugging HTML: use pastebin, separate out the relevant bits.
- getting help from the community
- applying Microformats.
Can others agree and or refine this list? Should I take it to the -discuss list? How do we create consensus on how the wiki should be organized in order to make it more usable? And how can we turn that consensus into actionable changes?
The wiki should also capture wisdom that stems from discussions that don't produce microformats. For example, Chris Messina suggests a "Best Of" page suitable for capturing this kind of wisdom. I think we can think of a given microformat as being at a place in a spectrum that ranges from "not yet thought of", to "interesting but needs work," or even "rejected", and of course including all the stages familiar to the microformats processes (eg examples, brainstorming, etc...). If there were such a page would it:
- Belong to a microformat? (eg hcard-bestof)
- or to the global namespace? (eg /wiki/wisdom/foobar-format)
(I think Chris Messina suggests that it belongs to a given microformat, but then how do we collect wisdom from non-microformats?)
Considering that the wiki page named with the microformat (i.e. /wiki/hcard) is the one that people will mostly likely look to first for learning about a particular format, I'd think it'd make more sense and create a more welcoming feel to convert these pages to an intro page introducing the format for the beginner and linking to resources like tutorials and creators. Spec pages would then be relocated to wiki/*-spec -- Cgriego 13:25, 16 Oct 2006 (PDT)
Mike Schinkel's Comments
My suggestion on the list was for us to use a convention that the entry page (i.e. https://microformats.org/wiki/hcard) would be an index into a list of (psuedo) standardized sub pages so that it would be very people to find what is important to them. For example, is a list of potential sub pages:
- Microformat
- Specification
- Tutorial
- Examples
- Use cases
- Reference
- Discussion
- Brainstorming (might be combined w/Discussion)
- Implementations
- Related Pages
- Further Reading
- All (Uses Mediawiki's "includes" to create a page including all sub pages; very useful for printing & reading offline)
These pages would be located respectively at
- https://microformats.org/wiki/hcard/
- https://microformats.org/wiki/hcard/Specification
- https://microformats.org/wiki/hcard/Tutorial
- https://microformats.org/wiki/hcard/Examples
- https://microformats.org/wiki/hcard/Use_cases
- https://microformats.org/wiki/hcard/Reference
- https://microformats.org/wiki/hcard/Discussion
- https://microformats.org/wiki/hcard/Brainstorming
- https://microformats.org/wiki/hcard/Implementations
- https://microformats.org/wiki/hcard/Related_Pages
- https://microformats.org/wiki/hcard/Further_Reading
- https://microformats.org/wiki/hcard/All
Please note I am suggesting an architecture not a specific list of sub pages. The list of sub pages should be defined by both reviewing existing information during site reorganization, and then via discussion on the list in an attempt to discover and extract which sub pages are needed for most/all microformats.
NOTE: This differs from above in that the spec if not viewed as a top level structure but instead the microformat itself and the spec would be under the microformat. In this context "microformat" is a more abstract concept and "spec" is a more concrete thing. Another way to think about it would be that each microformat would have it's own mini home page and then things like "spec" are the pages listed on its home page.
Matt Dertinger (Thewhoo)
hAtom2Atom
- Support for other XSLT engines:
- hAtom2Atom written using XSL 2.0
- Support for other output formats: (hAtom2xyz.xsl)
- RSS 2.0 (meanwhile use hAtom2Atom.xsl and atom2rss.xsl)
- RSS 1.0 (meanwhile use hAtom2Atom.xsl and atom2rss.xslt)
- AtomOWL (meanwhile use hAtom2Atom.xsl and atom2rdfxml.xsl)
Microformats Proposals
- rel="disclaimer":
- Purpose: to create a semantic linkage (relationship) between a foot-note or end-note marker and the actual location of the text that the marker refers to.
- rel="external":
- Purpose: to formalize what is already in existence in the wild. The use of rel="external" to refer to a document that is external or outside of the current domain.
Henri Bergius
- Add hKit support for automatically populating contact details into OpenPsa Contacts CRM
- Implement Tail scripts for adding things into Midgard
Justin Thorp
- Start researching examples for a To-do microformat
Mark Lentczner
- Get Second Life's event web pages to have proper event microformats data
- Start pinging pingerati.net/ping/$url when pages are updated
- Collaborate on designing how to integrate microformats, metadata and objects in Second Life.
Derrick Pallas
microformat proposal: dependancy
- looking for examples of directed graphs on the web
- applications in
- software engineering
- automatically build library dependency trees
- distribute security alerts to people that link to your code
- any directed, acyclic graph
- getting dressed in the morning
- cooking
- software engineering
- orthogonal to xfn
- people don't have versions
- libfoo requires libbar-2.0 or later
- people don't have optional relationships
- ex: at build time, compile in SSL support if present
- people don't have exclusive-or relationships
- ex: in Gentoo, syslog, syslog-ng, and metalog satisfy virtual/syslog
- ex: the Ruby library RMagick requires ImageMagick xor GraphicsMagick
- people don't have versions
Paul Downey
- building a generic Javascript parser
- bundling parser as a TidlyWiki plugin for hCards
- documenting how best to microformat TiddlyWiki pages
Rob Manson
- chase the admins to get some creation template extensions installed for wiki (see: https://meta.wikimedia.org/wiki/Inputbox or https://www.mediawiki.org/wiki/Extension:CreateBox or https://www.mediawiki.org/wiki/Extension:CreateArticle)
Clay Newton
- Work on getting others involved in trade-examples
- Need examples from major online banking sites
- Need examples from major ecommerce sites
- Continue working on: trade-brainstorming
Ben Ward
Recurring
- Delete Wiki Spam
Currently
- Gardening/updating key wiki pages.
- how-to-play
- XHTML Design Principals
- embed brainstorming
- Considering new welcome banner of µf.org to link to various µf resources, rather than being dominated by the infrequently updated blog.
Next Actions
- Conclude new hCalendar proposals from Yahoo TV Listings experience
- Resume work on hListing microformat
- Re-org the Microformats.org front-page content
- Work with User:Phae on refreshing the microformats frontpage content
- Build new events module for the blog using Upcoming.org, rather than hard coded event data (Matt Harris may have done this…)
- Build new wiki edits module for the blog
- Combine ‘list of microformats’ into the intro text? Make intro text more friendly.
- Build a microformats activity stream
- Replace front page blog with activity flow
- Wiki Edits/New Pages
- New Mailing List Threads
- Interesting µf links
- Blog posts
- Upcoming events/event reminders
- Replace front page blog with activity flow
- Improve µf.org/blog OpenID support, find a good workflow for login/comment (current plug-in has an abysmal user experience)
Ketan Majmudar
Activites
- Work on developing the hListing proposal
- Provide real world examples and apply this to the proposed specifications
- refine and keep up to date with hCard formats as used on existing sites [Ethical Junction CIC]
- Understand / follow and evangalise existing patterns, especially the new value-class-pattern
- see where I can help the community
- look at using x2v or writing php parser classes for hcard -> vcard
- open source hCard class (php) used to format db fields