[uf-discuss] Need for plain-language intros for each microformat
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
+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.
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.
More information about the microformats-discuss