Skip to content

Clarification of HTML elements in HTML lessons #2554

@naomiquinones

Description

@naomiquinones

Page where problem found?

HTML lesson
Portfolio Web Page 1

Type of problem

  1. Both pages list headers (Keywords section in HTML and Requirements section in Portfolio 1), but the correct HTML term for <h1> through <h6> is headings. In informal conversation, people sometimes say "header" when they mean "heading", but the HTML specification explicitly refers to the h1 through h6 elements as headings.
  2. Although there are links to other resources, the HTML lesson page does not clarify that HTML elements should be used only to create the structure, and not for how they look.

Suggested Solution

  1. It would be clearer to use the term "heading", and briefly contrast it with head and header, which are different elements.
  2. We should specify to the reader that they should use HTML elements for what they are, not how they look, giving examples where possible. For example, in the Misconceptions section, we could add something like, "I'll add an h1 here in the middle of the page because I want big bold text" and explain that it should be marked up as either a paragraph or lower level heading where appropriate for the structure of the page, and that we will use CSS to change how the elements look. Additional mention could be made of how using semantically correct structure helps for accessibility.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions