[uf-discuss] Need for plain-language intros for each microformat

Manu Sporny msporny at digitalbazaar.com
Wed Aug 29 07:59:03 PDT 2007

Andy Mabbett wrote:
> I think it's time we moved the specs to *-spec or *-specification, and
> used the "root" page for each microformat, such as the above, for a
> plain-language introduction, taking care to avoid jargon as much as
> possible.

+1 for this idea. There have been several times where I've pointed
somebody to a uF specification page to give them an overview and they
just come back claiming that the page didn't really tell them
anything... or worse, it confused them.

> <http://en.wikipedia.org/wiki/Hcard>

The page should be a short introduction and shouldn't overwhelm the
reader. Perhaps a 1-2 paragraph introduction, a very simple example, and
links to other wiki pages at the bottom with more information.

-- manu

More information about the microformats-discuss mailing list