W3C home > Mailing lists > Public > public-html-comments@w3.org > May 2009

section 3 top headers

From: Shelley Powers <shelleyp@burningbird.net>
Date: Sat, 02 May 2009 10:38:44 -0500
Message-ID: <49FC6904.7040200@burningbird.net>
To: public-html-comments@w3.org, whatwg@whatwg.org
More on HTML5 draft review:

Your top level section headers in Section 3 don't make a lot of sense.

In particular, you insert a section on the paragraph element, at the 
same top level that you reference all HTML elements. Why did you plunk 
the paragraph in as a separate section? And I'm also assuming I misread 
the bit about other elements straddling paragraphs. I'm assuming you 
don't mean that something like

And let's look at the section headers:

Content Models
APIs in HTML documents
Dynamic Markup insertion

There's no cohesive pattern to this section. One moment you're talking 
about Elements in the DOM, the next paragraph elements. And you're 
actually defining the paragraph element, but the elements are described 
fully in Section 4. Where you also describe the paragraph element.

That's a lot of jumping around for folks.

More later

Received on Saturday, 2 May 2009 15:39:26 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:26:25 UTC