This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 7656 - Describe differences between easily confused new elements to assist authors
Summary: Describe differences between easily confused new elements to assist authors
Status: NEW
Alias: None
Product: HTML WG
Classification: Unclassified
Component: HTML5 Reference (editor: Lachlan Hunt) (show other bugs)
Version: unspecified
Hardware: PC All
: P2 minor
Target Milestone: ---
Assignee: Lachlan Hunt
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords: NE
Depends on:
Blocks:
 
Reported: 2009-09-16 17:21 UTC by Oli Studholme
Modified: 2009-09-21 10:01 UTC (History)
5 users (show)

See Also:


Attachments

Description Oli Studholme 2009-09-16 17:21:04 UTC
As requested in IRC:
boblet: Hixie: new descriptions are clear for ppl who understand the distinction, but could each use a sentence describing the difference (similar to the one in <section> about diffs with <div>)

It looks like this is already done, but just in case. It might be good to have something like the following in the spec/wiki/Lachy’s guide:

# New sectioning elements in a nutshell:
* <section>—a generic chunk of related content
* <article>—an independent, self-contained chunk of related content, that still makes sense on it’s own (eg in an RSS feed)
* <aside>—a chunk of content that is tangentially related to the content that surrounds it, but isn’t essential to understanding that content
* <nav>—navigation for the site or page
* (cf. <div>—a generic chunk of content with no additional semantics, eg for CSS styling hooks)

(from top of http://boblet.tumblr.com/post/141239118/html5-structure4 )
Comment 1 Ian 'Hixie' Hickson 2009-09-21 10:01:10 UTC
I looked into adding a usage summary for the sectioning elements, but I was worried that having multiple definitions (especially a normative full one and a non-normative and more terse summary one) would confuse at least as many people as it helped. The text we have now for the elements is pretty carefully phrased to avoid as much confusion as possible, I don't want to add more text that might confuse things again.

Punting to Lachy's draft  feel free to reassign to me if you have a concrete idea of how to do this without causing more problems than it solves.