Chapter 3. Writing Style

If content is what you communicate, then style is how you communicate. Writing style is determined by all the decisions that you make while creating a document, such as the type and tone of information you present, choice of words, language and format consistency, use of technical terms, and so forth. In the literary world, style is judged in part on artistic grounds, which might be highly subjective. In the field of technical documentation, however, experience and practice have provided objective criteria for evaluating style.

This chapter presents some guidelines for writing effectively. It discusses the following topics:

• “Why Is Style Important?” on page 89

• “Stylistic Principles” on page 90

• “Some Basic ...

Get Read Me First! A Style Guide for the Computer Industry, Third Edition now with O’Reilly online learning.

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