style-guide

From Microformats Wiki
Revision as of 20:43, 25 November 2007 by Tantek (talk | contribs) (drafted to jot down some notes about affiliation)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

style guide

Some notes on styling suggestions for microformats specs.

by Tantek

start with w3c manual of style

In general, a lot has been adapted from the W3C manual of style and that is a good reference to start with.

Some specific changes:

affiliation

The W3C manual of style section on editors provides some good guidelines for affiliations. We make the following explicit changes from their guidelines:

  • focus on the people not organizations. To better attribute editorship/authorship to individual people (rather than their organizations), microformats specs put affiliations in parentheses.
  • explicit hCard markup. We have begun marking up the editor(s)/author(s) of microformats specs with hCard.

The hCard spec itself provides a good example of both of these points:


Authors
Tantek Çelik (affiliations above)
Brian Suda (http://suda.co.uk/)


examples

Currently the hCard and hResume specifications have perhaps the most updated/modern use of styling among microformats specifications. Look at those two as an example of what to mimic.

see also