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 books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
