[uf-discuss] Q&A

Angus McIntyre angus at pobox.com
Thu Dec 14 06:47:41 PST 2006

At 18:28 +0900 14.12.2006, Michael(tm) Smith wrote:
>What semantic markup would be useful for a complete FAQ?
>   <div class="qaset">
>     <h1>Microformats FAQ</h1>
>     <p>This page document frequently asked questions about microformatsŠ</p>
>     Š
>     <div class="qadiv">
>       <h2>&lt;div> and &gt;span> semantics</h2>
>       <dl class="qa">
>         <dt class="qtn">Is it semantically meaningless to use divs?</dt>
>         <dd class="ans">Š</dd>
>       </dl>
>       Š
>     </div>
>   </div>
>Overkill? Or missing something?

It looks good to me.

As an 'example in the wild' consider:


This has visually the same structure as yours:


but a different markup structure, i.e. <p> ... 
<div> instead of <dt> ... <dd>. However, it could 
very easily be recast to use your markup, 
suggesting that your proposal would fit at least 
that example.

One thing it does include which you might want to 
add to your proposal is a <span> that is used to 
mark the numbering for each question, i.e. the 
author uses:

	<p class="question">
	   <span class="questionnumber">3.2</span> Yadda Yadda Yadda</p>

For other examples in the wild, see:


Many of these also pull out an index of questions 
('table of contents') to the head of the 
document. Supporting that programmatically (i.e. 
writing something to traverse the QA list and 
generate a table of contents) would presumably 
require adding <a> elements to the 'div.qadiv h2' 
and 'dt.qtn' elements: would this have any 
implications for the design?


More information about the microformats-discuss mailing list