how-to-start-a-new-microformat

From Microformats Wiki
Jump to navigation Jump to search

The New Microformat HOW-TO

This HOW-TO provides a step-by-step tutorial in the process of creating a new Microformat from beginning to end.

Step 1: Determine if a New Microformat is Needed

In many cases, a new Microformat is not needed. Microformats are meant to be combined with one another, therefore most problems can be solved by combining a number of Microformats. Here is a step by step guide to determining if a new Microformat is needed:

  1. Create a Problem Statement
    1. The Problem Statement is a very specific paragraph that outlines the problem that you are trying to address. If you need an example of an initial problem statement, one can be found here: hAudio Problem Statement. Once you have finished your problem statement, proceed to the next step.
  2. Apply pre-existing Microformats to your Problem Statement
    1. There is a large list of Microformat specifications, drafts and exploratory discussions that could be applied to your Problem Statement. Make sure to check the list and see if your problem can be solved using a combination of the pre-existing Microformats. If you have not found a combination of Microformats that can address your problem statement, proceed to the next step.
  3. Ask the microformats-new mailing list for guidance
    1. There are a number of people that have been active in the community for a long time. If you have done the first two steps and you still think that your problem is not being addressed by the Microformats community, ask the microformats-new mailing list. Make sure to include your Problem Statement and let the list know that you are considering creating a new Microformat to address the issue. Be ready for a variety of answers - the community rarely agrees when a new topic arises. It may take a bit of discussion to determine if a new Microformat is needed.

Step 2: Gather Examples and Similar Projects

Step 3: Analyze the Examples for Common Attributes

Step 4: Document the Analysis on the Wiki and Ask for Feedback

Step 5: Brainstorm Usage Scenarios and Proposals

Step 6: Write the First Draft

Step 7: Gather Feedback on First Draft

Step 8: Refine

Step 9: Propose Acceptance by the Community

Step 10: Gather Implementations of the Standard