- Print
- DarkLight
Ornamentation guidelines
Use ornamentation to distinguish particular types of information and to assist with readability. In general, avoid ornamenting text with boldface, italic, underlining, colour, and capitals unless there is a clear reason to do so. Over-ornamentation makes the text difficult to read, and it dilutes the impact of when it is used.
The following guidelines only apply to the text. Ornamentation is widely used in heading styles, including run-in headings that appear at the beginning of a paragraph.
Ornamenting general text
Style | Usage |
---|---|
Italic |
|
Boldface | Use to show emphasis, but only in informal documents, and then only selectively. |
Underlined | Use to show emphasis but use selectively. |
Capitalized | Proper nouns, proper adjectives, formal titles, descriptors to numbered cross-references, and defined terms (see Capitalization) |
Full caps | Do not use in general text but commonly used in headings |
Small caps | Often used in combination with italic to format the names of institutes in post-nominals. |
Colour | The use of coloured text and text with a coloured background is determined by your template or corporate style. In general, avoid using too many coloured text styles so that, when they are used, they have the desired effect of attracting the attention of the reader or, if a subdued colour is used, of reducing the focus on that part of the text. |
Font style | Fonts are usually controlled by the template or corporate style. Note that a newspaper-style font, such as Times New Roman, is considered to be more readable that most modern fonts, such as Arial and Verdana. Avoid elaborate font styles—they reduce the readability of the document. In general, use a monospaced font, such as Courier New, for file names, URLs, equations, and text that the reader might need to type. |
Font size | Font size is usually controlled by the template or corporate style. In general, use font sizes between 9 pt to 11 pt for normal text. Smaller sizes (but not less than 7 pt) can be used for tables and call-outs in figures and for ancillary text that is less important or is not part of the main text, such as copyright notices, footnotes, footers, and other notations. |
Ornamenting text in user guides (IT)
Style | Usage |
---|---|
Italic | Titles of publications quoted in text, and placeholders for text that the user types |
Boldface | User interface labels and literals |
Underlined | Avoid |
Capitalized | Proper nouns, product names, and interface labels |
Full caps | Do not use |
Small caps | Keyboard keys |
Colour | Follow your project style |
Monospaced font | File names, URLs, equations, and any text that the user is expected to type |