Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Already on GitHub? Sign in to your account

Circular definitions in their summaries of new html5 semantic elements. #41

Closed
tchalvak opened this Issue Mar 20, 2012 · 3 comments

Comments

Projects
None yet
2 participants
Contributor

tchalvak commented Mar 20, 2012

The spec defines the article element like this:

"The article element represents a self-contained composition in a document, page, application, or site and that is, in principle, independently distributable or reusable, e.g. in syndication. This could be a forum post, a magazine or newspaper article, a blog entry, a user-submitted comment, an interactive widget or gadget, or any other independent item of content."

Here on this page of w3schools, we can see that the "new html5 elements" page:

http://www.w3schools.com/html5/html5_new_elements.asp

Summarizes article with: Defines an article.
and section with: Defines a section of a document

As if those elements weren't already hard enough to figure out.

Here:

http://www.w3schools.com/html5/tag_section.asp

In the page dedicated to section, they explain section as:

Definition and Usage

The section tag defines sections in a document. Such as chapters, headers, footers, or any other sections of the document.

I cringe for any new webdeveloper trying to learn html5 from the first site result for "new html5 semantic tags", and for the rest of us ever being able to solidify the purpose of those two tags.

Contributor

addyosmani commented Jul 12, 2012

@tchalvak would you like to put together a pull request addressing this?

Contributor

tchalvak commented Jul 13, 2012

Yeah, I'll try to get to that when I can.

On Thu, Jul 12, 2012 at 10:13 AM, Addy Osmani <
reply@reply.github.com

wrote:

@tchalvak would you like to put together a pull request addressing this?


Reply to this email directly or view it on GitHub:
#41 (comment)

+++++++++++++++++++++++++++
BitLucid.com http://bitlucid.com/ - BitLucid, Inc. - Web & Programming
Consultants
ninjawars.net - My webgame project
github.com/tchalvak/ninjawars - My open source projects
dnaexmosn.deviantart.com - Art Gallery
585-519-7658 - Cell
"Never compare your inside with somebody's outside."

Contributor

tchalvak commented Apr 26, 2013

Boy oh boy was I quick at acting on this isssue.......

@tchalvak tchalvak closed this Apr 26, 2013

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment