[uf-discuss] Q&A

[Angus McIntyre]

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:

	http://spamnation.info/notes/guides/GeneralAdvice.html

This has visually the same structure as yours:

	set
	   subset
	      question
	      answer
	      question
	      answer

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:

	http://www.faqs.org/

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?

Angus