From Microformats Wiki
examples /
Revision as of 16:25, 6 October 2005 by DrErnie (talk | contribs) (best)
Jump to navigation Jump to search

Best Practices for Example Pages

Example pages are the first stage of the exploration The microformats process which must precede proposing a new microformat. Current explorations are listed on the Welcome to the microformats wiki!.

Purpose of Example Pages

(adapted from The microformats process)

Document current human behavior. Remember, we're paving the cowpaths- before you do that you have to find the cowpaths. Your documentation should be a collection of real world sites and pages which are publishing the kind of data you wish to structure with a microformat. From those pages and sites, you should extract markup examples and the schemas implied therein, and provide analysis.

Recommended sections

Top level (=):

  • Introductory sentence

Second level (==):

  • Purpose (The Problem)
  • Participants
  • Real-World Examples
  • Existing Practices
  • Proposal (when available)
  • See Also

Good Examples of Examples

The following pages are some of the best examples of instantiating this design pattern: