O'Reilly logo

The IBM Style Guide: Conventions for Writers and Editors by Eric Radzinski, Leslie McDonald, Amy Laird, Jana Jenkins, Peter Hayward, Francis DeRespinis

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 7. Computer interfaces

Document computer interfaces in an accurate, clear, and consistent way to make it easier for users to meet their goals.

Commands

Apply the correct capitalization and fonts to commands, their parameters, and their options (the values of parameters). Show the syntax of commands, and explain the meanings of the parameters and options.

Capitalization

If the command language is case sensitive, show the commands, parameters, and options as they must be entered from the console, terminal, or keyboard. If the command language is not case sensitive, show the commands, parameters, and options in lowercase. If you write information for multiple operating systems and the command language is case sensitive on one operating system ...

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