Difference between revisions of "examples"

From Microformats Wiki
examples
Jump to navigation Jump to search
(best)
Line 13: Line 13:
 
* Introductory sentence
 
* Introductory sentence
 
Second level (==):
 
Second level (==):
* Purpose (The Problem)
+
* The Problem)
 +
** ''What is the purpose of this exploration?''
 
* Participants
 
* Participants
 +
** ''Bulleted list of who is active (or cares)''
 
* Real-World Examples
 
* Real-World Examples
 +
** ''Links to public web pages, either popular or insightful''
 
* Existing Practices
 
* Existing Practices
* Proposal (when available)
+
** ''Summary of common patterns discovered''
 +
** ''Other attempts to solve The Problem''
 +
* Proposal
 +
** ''Link to related pages as they become available''
 
* See Also
 
* See Also
 +
** ''Other micrformats''
 +
** ''Normative references for tags used''
  
 
== Good Examples of Examples ==
 
== Good Examples of Examples ==

Revision as of 16:41, 6 October 2005

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 (==):

  • The Problem)
    • What is the purpose of this exploration?
  • Participants
    • Bulleted list of who is active (or cares)
  • Real-World Examples
    • Links to public web pages, either popular or insightful
  • Existing Practices
    • Summary of common patterns discovered
    • Other attempts to solve The Problem
  • Proposal
    • Link to related pages as they become available
  • See Also
    • Other micrformats
    • Normative references for tags used

Good Examples of Examples

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