examples: Difference between revisions
Jump to navigation
Jump to search
(cleanup) |
|||
| Line 1: | Line 1: | ||
= Best Practices for Example Pages = | |||
= Purpose of Example Pages = | '''Example''' pages are the first stage of the exploration [[process]] which must precede proposing a new microformat. Current [[Exploratory Discussions]] are listed on the [[Main page]]. | ||
== Purpose of Example Pages == | |||
(adapted from [[process]]) | (adapted from [[process]]) | ||
Document current human behavior. Remember, we're [http://ifindkarma.typepad.com/relax/2004/12/microformats.html 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. | Document current human behavior. Remember, we're [http://ifindkarma.typepad.com/relax/2004/12/microformats.html 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 = | == Recommended sections == | ||
= | Top level (=): | ||
* Introductory sentence | |||
* | Second level (==): | ||
* | * Purpose (The Problem) | ||
* | * Participants | ||
* | * Real-World Examples | ||
* Existing Practices | |||
* See also | |||
Revision as of 16:13, 6 October 2005
Best Practices for Example Pages
Example pages are the first stage of the exploration process which must precede proposing a new microformat. Current Exploratory Discussions are listed on the Main page.
Purpose of Example Pages
(adapted from 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
- See also