Tantek: drafted to jot down some notes about affiliation

2007-11-25T20:43:36Z

drafted to jot down some notes about affiliation

New page

<h1>style guide</h1>
{{TOC-right}}
Some notes on styling suggestions for microformats specs.

by [[User:Tantek|Tantek]]

== start with w3c manual of style ==
In general, a lot has been adapted from the [http://www.w3.org/2001/06/manual/ W3C manual of style] and that is a good reference to start with.

Some specific changes:

== affiliation ==
The [http://www.w3.org/2001/06/manual/#Editors 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|hCard spec]] itself provides a good example of both of these points:

<div class="vcard">
; <span class="role">Editor</span>
: <span class="fn">[[User:Tantek|Tantek Çelik]]</span> (<span class="url">http://tantek.com/</span>, and before at [http://technorati.com Technorati, Inc.], and at [http://microsoft.com/ Microsoft Corporation])
</div>
; Authors: [http://tantek.com/ Tantek Çelik] (affiliations above)
: <span class="vcard"><span class="fn">[[User:Brian|Brian Suda]]</span> (<span class="url">http://suda.co.uk/</span>)</span>

== examples ==
Currently the [[hcard|hCard]] and [[hresume|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 ==
* [[how-to-play]]

style-guide - Revision history

Tantek: drafted to jot down some notes about affiliation