O'Reilly logo

Read Me First! A Style Guide for the Computer Industry, Third 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 B. General Term Usage

This appendix lists and briefly explains how to correctly use terms that writers and editors frequently look up.

Note

Use the terms as stated in the table in this appendix, and capitalize and punctuate them as shown.

Certain terms might appear differently in products, applications, or other material you are documenting. For example, many companies say “log in,” not “log on.” However, if the audience you are writing for is accustomed to “log on,” use that terminology. Another example is that of “root” and “superuser.” Follow the style of the material you are documenting.

See also these sections in this guide for related guidelines and examples:

• “Capitalization” on page 25

• “Punctuation” on page 39

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