examples: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(cleanup)
Line 1: Line 1:
= Best Practices for Example Pages =
= 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]].
'''Example''' pages are the first stage of the exploration [[process]] which must precede proposing a new microformat. Current [[Main Page#Exploratory Discussions|explorations]] are listed on the [[Main Page]].


== Purpose of Example Pages ==
== Purpose of Example Pages ==

Revision as of 16:16, 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 explorations 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