Best Coding Practices

HTML Markup

Use heading tags to show the document structure

Headings should be properly nested. There should only be one h1 on the page. Headings at the next level down should be marked using h2 and at the next level h3, and so on. An h3 should never follow an h1.

Use ordered and unordered lists for numbered or bulleted lists

  • item 1
  • item 2
  • item 3

Information may be placed into lists to emphasize the information, group
the information, or represent the information in a certain order. Knowing why you are placing information in a list layout will allow you to select the correct type of list to use.

Using appropriate markup for lists is a requirement for Level 2 accessibility compliance with the W3C. Don’t use images as bullets, rather use CSS to style your list bullets.

Different visual formatting effects can be applied to unordered lists through the use of style sheets.

Use the table header element for header rows in data tables

If your table supplies data for the user, you should designate a header row, a header column, or both for your table.

Highlight text with <em> or <strong>

In graphical browsers, “emphasis” is generally displayed as italic text and “strong” is generally displayed as bold.

Do not use HTML tags for visual effect alone

  • Do not use headings to increase the size of text that does not function as a heading
  • Do not use “blockquote” or “li” to indent textthat is not a quotation or list.


Submit a Comment