Chapter 8. Style


The best style is the style you don’t notice.

—W. Somerset Maugham

Style is the correctness and appropriateness of writing according to conventions. Like visual effectiveness, style is an expression of the “look and feel” of information. Maintaining a style for technical content means following standards and rules to ensure consistency and correctness.

Style and content are inextricably linked: consistent style helps users focus on the content and not on why one term is highlighted in bold in one place but not another. However, style isn’t simply decoration that you apply to information—style helps users understand the information. ...

Get Developing Quality Technical Information: A Handbook for Writers and Editors, Third Edition now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.