<figure> bugs in Differences document

Due to an error Laura made me aware of [1], I have taken a closer look 
at what the HTML4-HTML5 Differences document says about <figure>. I 
would like all these bugs to be corrected before Hearth Beat 
publication.

* Section 5.2 Changes from 25 August 2009 to 4 March 2010: [2]

]]
The figure element now uses a new element figcaption rather than legend 
because people want to use HTML5 long before it reaches W3C 
Recommendation.
[[

Bug 1. The last part "because people want to use HTML5 long before
       it reaches W3C Recommendation" seems extremely 
       laconic/political/ironic. 
Request: Please strike this part of the sentence.

Bug 2. Another spec change is not mentioned at all: between August
       2009 and March 2010, <figure> was moved from section 4.8 
       Embedded content to section 4.5 Grouping content.
       See the ToC: http://www.w3.org/TR/html5/#auto-toc-4
Request: Please say that it was moved. And, if you can point
         to a reason for it, say why it was moved.

* Also in section 5.2, immediately after the figure paragraph:

]]
The details element now uses a new element summary for exactly the same 
reason.
[[

Bug 3: "The details element now uses a new element summary for
        exactly the same reason."
Request: strike the text "for exactly the same reason".


* Section 3.1 New Elements: [3]

]]
figure[1] can be used to associate a caption together with some 
embedded content, such as a graphic or video:
	<figure>
		<video src="ogg"></video>
		<figcaption>Example</figcaption>
	</figure>
figcaption provides the caption. 
[1] 
http://www.w3.org/TR/html5/embedded-content-0.html#the-figure-element
[[

Bug 4: It is does not reflect HTML5 to present <figure> as a a way
       to provide captions for embedded content. (It does however 
       match Shelley's change proposal before she changed it to a
       proposal to remove <figure>.
Request: Describe what <figure> is meant for.

Bug 5: The URL to HTML points to the incorrect section *and* it it
       does not point *directly* to the heartbeat draft.
           <a href="
           http://www.w3.org/TR/html5/embedded-content-0.html
           #the-figure-element"><code>figure</code></a>
Request: Correct the URL

[1] http://lists.w3.org/Archives/Public/public-html/2010Jun/0206
[2] http://dev.w3.org/html5/html4-differences/#changes-2009-08-25
[3] http://dev.w3.org/html5/html4-differences/#new-elements
-- 
leif halvard silli

Received on Wednesday, 9 June 2010 09:27:43 UTC