Left Content
-
Write a descriptive heading for the entire document and use H1 element with
ALIGN=CENTER attribute for it.
-
Divide the document into major parts (sections), write suitable titles for
them, using H1 with ALIGN=LEFT. In this and further divisions, try to avoid
having more than seven parts.
-
If necessary, divide each major part into smaller parts with H2 headings, and
if needed divide each of these subsections into subsubsections with H3
headings. Avoid using H4 headings and especially H5 and H6 headings, both
because they are often rendered with a very small font and because more than
three levels of structure tends to make the document hard to read. (If you
still feel tempted to use H4, consider dividing the entire document into
smaller documents.)
-
If you have a section with, say, H2 heading and containing H3 headings, avoid
inserting text between the H2 heading and the first H3 heading. Such "homeless"
text can be acceptable if it only contains very short notes such as general
orientation, some remarks about the section, or a motto. Long homeless texts
confuse the reader who does not see your good intentions; therefore, use a
subsection with a heading of the appropriate level and with text like
Introductory remarks, Generalities or Summary.
-
Divide the smallest parts of the above-mentioned structure into paragraphs or
paragraph-like blocks (namely lists or tables). as described below. Notice that
in HTML you must explicitly indicate paragraph division by HTML elements;
leaving just an empty line does not cause a paragraph break.
-
Within paragraphs, use text level markup, normally phrase markup, to
distinguish special text segments from normal text, e.g. to indicate quotations
of computer output or to emphasize key words.
-
Add links and, if applicable, images or other illustrations.
From
Learning HTML 3.2 by Examples
.