Current docs page contains incorrect information re. typographic elements

[matthewpennell]

From http://twitter.github.com/bootstrap/#typography:

Emphasis tags (<strong> and <em>) should be used to add visual distinction between a word or phrase and its surrounding copy. Use <strong> for plain old attention and <em> for slick attention and titles.

This is wrong. As per the HTML5 spec (http://dev.w3.org/html5/spec/Overview.html):

The strong element represents strong importance for its contents.
The em element represents stress emphasis of its contents.

These two tags therefore have semantic meaning - they are not simply for adding "visual distinction" to words or phrases, or whatever "slick" attention is.

Note: It’s still okay to use <b> and <i> tags in HTML5, but they don’t come with inherent styles anymore. <b> is meant to convey importance

This is also wrong - again from the spec:

The b element represents a span of text to which attention is being drawn for utilitarian purposes without conveying any extra importance and with no implication of an alternate voice or mood

So the actual specification is almost the exact opposite of your documentation's claims.

[matthewpennell]

Submitted a pull request.

[lukeholder]

@matthewpennell:

Dude, have you got a chip on your shoulder? Sounds like you think a html5 spec is a holy book to be translated by those who have the gift of prophecy and enough intellect. Were they meant to quote the spec?

I get the feeling you are annoyed they had the audacity to try explain how to use html tags - and maybe even purposely misguiding people with their "claims".

You just make websites - calm down.

[matthewpennell]

Um, okay.

The point of a spec is exactly not that it is only accessible to the super-smart, and the authors of the HTML5 spec have actually gone out of their way to make sure it isn't an impenetrable tech document that nobody ever reads. Anyone that "just makes websites" should be at least familiar with it.

I'm not annoyed; I just think it's important that any high-profile project such as this one doesn't spread incorrect information about the meaning of elements and when/how they should be used. I guess the authors agree with me, as they accepted my patch with an amended correct explanation of the meaning of those tags.

52e9f7e

You may "just make websites" - I try to do it properly. :)