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

_______________________________________________
microformats-discuss mailing list
microformats-discuss@microformats.org
http://microformats.org/mailman/listinfo/microformats-discuss

Reply via email to