Copyright © 1998-02-08 rev 2008-01-23
The widespread use of word processors has permitted – even forced – many technical authors to typeset their own work. But most technical authors have no familiarity with the principles of typesetting. This note catalogs what I consider to be the ten most common mistakes, in descending frequency of incidence.
You are reading the HTML version of this document. A typographic-quality version of this document is available in Acrobat PDF format.
A surprising number of technical authors fail to clearly identify their work. If you want your reader to be certain who wrote the work, to cite it, and to determine whether he or she has the most recent version, you must take care to provide complete information on the first page.
Curiously, in the original paper describing the technical foundation of Google, the authors neglected to put their names on the paper! Bibliographic data, including the identities of the authors, can be found at the Stanford InfoLab Publication Server entry. The paper itself is available in PDF format:
Larry Page, Sergey Brin, R. Motwani, and T. Winograd, The PageRank Citation Ranking: Bringing Order to the Web (Stanford Digital Library Technologies Project publication 1999-6).
A 66‑character line is widely regarded as ideal for readability. With 12-point Courier type – so-called Pica, with ten characters per inch – 66 characters make a 6.6‑inch line. Set on an 8.5‑inch page width, this leaves a reasonable margin of about an inch on each side. But 12‑point type, especially Courier, is too large for all but very unusual cases. With 10‑point Palatino, quite suitable for a technical document, a typical 6.6‑inch line has 100 characters, far too many for continuous reading. To use 10‑point Palatino, a line length of about 4 1/8 inches would be ideal. If you want to use a single column, consider using 11‑point type in a column about 5 inches wide. If your document is almost wholly text, consider using 9-point type in a layout with two 3‑inch columns.
In the Courier typeface, and other typefaces restricted by the mechanical constraints of typewriters, the letter i is forced to have the same set width as the letter W. It is quite legitimate to use Courier, or another monospace font, if you want your document to look like it was produced on a typewriter. But if you want a document to appear attractive and permanent, choose a proportional font.
It is obviously necessary to distinguish headings (or heads) from body text. Normally, a head is placed in the margin, or set off by spacing. In these circumstances, it is unnecessary to set the head in a size larger than the body type, and usually unnecessary to use a different font family. If you are unfamiliar with typesetting, simply set the head in boldface type of the same size as the body face.
Underlining is strictly for typewriters. Modern word processors and page layout programs give access to italic typefaces: Use italics for emphasis. To use boldface would make your page look blotchy. Use quotation marks only for their intended purpose: quotations. To use quotation marks for emphasis is disruptive to smooth reading of your text.
Follow the period at the end of a sentence by a single space, not two. Use a single paragraph mark to terminate a paragraph, not two. On a typewriter, you are forced to set two hyphens in place of a dash, but in typeset work you can use an en dash – like this – surrounded by normal (word) spaces. To achieve spacing, or to force a paragraph to the top of a page, use your word processor's spacing and positioning controls instead of blank lines. It is wrong to set two hyphens in place of a dash: Use an en dash surrounded by normal (word) spaces. Modern word processors and page layout programs allow you to use typographic characters. Use the straight single and double quotes ' and " only to denote minutes, seconds, feet, and inches; and then only if there is insufficient space to spell out the unit. For an apostrophe, use the proper typographical character (‘); for quotations, use typographer‘s ‑curly” quotes. (These may be accessible through your word processor‘s smart quotes feature.)
Modern word processors allow you to control line breaks and hyphenation. Use a nonbreaking space to prevent adjacent elements – such as a numerical quantity and its associated unit – from being separated by a line or page break. Use a nonbreaking hyphen to avoid the elements of a compound modifier, such as 35‑millimeter, from being broken at a line-end.
A surprising number of technical authors fail to clearly separate their paragraphs. This makes their work hard to read. Choose one of two methods to identify paragraphs: Either indent the first line of every paragraph, or use no indentation and establish paragraph formatting such that paragraphs are separated by the equivalent of a blank line.
Set a fraction using superscript for the numerator and subscript for the denominator. Use the fraction slash character as a separator – on a Macintosh, access it as Shift‑Option‑1.
If your document includes figures oriented differently from the text, it will be necessary for the reader to rotate your document. You must ensure that he or she has to turn the document only once per page, and always in the same direction. I suggest that you arrange the layout so that the reader rotates the body text clockwise 90 degrees to view a figure. In other words, when viewing the text in its natural orientation, place the top of a rotated figure to the left.
Charles Poynton