October 2011
Intermediate to advanced
416 pages
8h 15m
English
book
IBM Style Guide, The: Conventions for Writers and Editors
by Francis DeRespinis, Peter Hayward, Jana Jenkins, Amy Laird, Leslie McDonald, Eric Radzinski
Content preview from IBM Style Guide, The: Conventions for Writers and EditorsBecome an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
Start your free trial
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 ...