[Bug 23019] New: Add ’quotations’ as one the types of content <figure> can be used to annotate

https://www.w3.org/Bugs/Public/show_bug.cgi?id=23019

            Bug ID: 23019
           Summary: Add ’quotations’ as one the types of content <figure>
                    can be used to annotate
    Classification: Unclassified
           Product: HTML WG
           Version: unspecified
          Hardware: PC
                OS: Windows NT
            Status: NEW
          Severity: normal
          Priority: P2
         Component: HTML5 spec
          Assignee: dave.null@w3.org
          Reporter: xn--mlform-iua@xn--mlform-iua.no
        QA Contact: public-html-bugzilla@w3.org
                CC: faulkner.steve@gmail.com, heydon@heydonworks.com,
                    mike@w3.org, public-html-admin@w3.org,
                    public-html-wg-issue-tracking@w3.org,
                    xn--mlform-iua@xn--mlform-iua.no
        Depends on: 22996

CURRENTLY the spec says about <figure>:

”The element can be used to annotate illustrations, diagrams, photos, code
listings, etc.”

   PROPOSAL:

Add the word 'quotations', like so:

“The element can be used to annotate illustrations, diagrams, photos, code
listings, <INS>QUOTATIONS,</INS> etc.”

I would also recommend to add a note which says that, when used for quotations,
the quotation should be placed in a <blockquote> or <q> element.

   JUSTIFICATION/USE CASES

1) From data presented to public-html [*], it seems that many authors, for
various reasons, place metadata (such as source info) about a quotation
*outside*, but adjacent to, the <blockquote> element. However, from the same
data, very few seem to be aware that they can use <figure> plus <figcaption>
for this. Hence, this should be pointed out.
  [*] http://lists.w3.org/Archives/Public/public-html/2013Aug/0100.html

2) Quotations, especially when they have an annotation, tend to match HTML5’s
description of a figure as being ”self-contained” and “typically referenced as
a single unit from the main flow of the document”. They can also often “be
moved away from that primary content” … "without affecting the flow of the
document".

   PROS

* No semantics are changed - it is already allowed. It just enlightens those
that are interested in, or satisfied with, keeping the annotation separate
from, but still linked to, the quoation.

* No rules are change: This method is compatible with the prohibition on
placing metadata inside <blockquote> (or <q>).

* This method of annotating quotations does not prohibit that the HTMLwg
*eventually* also adds child element of <blockquote> for annotation. For
instance, the spec points out that figure may also be used to annotate <table>
- it recommends to not use <caption> in that case, but does not prohibit or
deprecate the use of <caption>.

* This method is already in use:
https://www.w3.org/Bugs/Public/show_bug.cgi?id=22996#c1

* Figure had good, and improving support, including in AT

* This solution offers a method for annotating the <q> element:
  <figure>
    <q cite="URL">I have a dream</q>
    <figcaption><cite>Martin Luther King Jr</cite></figcaption>
  </figure>

   CONS

* No particular cons.

-- 
You are receiving this mail because:
You are on the CC list for the bug.

Received on Tuesday, 20 August 2013 13:34:33 UTC