O'Reilly logo

Read Me First!: A Style Guide for the Computer Industry, Second Edition by Sun Technical Publications

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

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 63

  • “Stylistic Principles” on page 64

  • “Some Basic Elements of Style” ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required