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

Appendix C. Correct Usage of Terms

The following table provides alternatives for terms that you should not use in technical documentation, and terms that you should avoid. The table also provides some guidance related to commonly confused words and terms. See also these sections in this book for related guidelines and examples:

  • “Capitalization”on page 2

  • “Hyphen”on page 23

  • “Redundancies”on page 78

  • “Abbreviations and Acronyms”on page 11

  • “Units of Measurement”on page 13

Table C-1. Questionable Terms and Their Alternatives

Term

Usage

#

Do not use as an abbreviation for number. Use “no.” instead.

above

Do not use to refer to the location of another piece of information. Instead, use “previous” or “preceding,” or refer to the specific section title or figure number, ...

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