Use | Preferred Emphasis | Example | Notes |
Simple emphasis | Bold or Italics | Do
not
turn off the computer before shutting it down.
Do not turn off the computer before shutting it down. |
Use your best judgement as to whether bold or italics works better. Generally, the most effective method will be whichever method you are NOT using elsewhere in your PR. |
Lead-in labels in list items | Italics |
|
Generally italics is preferred, but bold is also acceptable. |
Labels on special notices. | Bold | WARNING! Do not run the COMMIT command unless you are sure the data were updated correctly. | Only bold the label itself. You do not need to bold the entire comment. In fact, emphasizing the entire comment will actually make the reader less likely to pay attention to it than simply making the label bold (and perhaps all caps if it is really serious). |
File names & paths | Inline Code or Bold or Italics | Paste
text.txt
to the *C:\Users\Administrator\Documents* directory.
Paste text.txt to the _C:\Users\Administrator\Documents_ directory. |
Consider using inline code as an alternative to bold or italics. This will allow you to reserve bold and italics for emphasis. |
Computer Commands or Keyboard Strokes (within text) | Inline Code | Always use inline code (or a code block) for computer commands and keystrokes. | |
Information that readers supply | Inline Code | Always use inline code (or a code block) for any typing the user must perform. | |
Buttons that initiate commands (within text) | Inline Code or Italics | Press the
Exit
button to exit the application.
Click the left mouse button . |
Sometimes it is useful to make a distinction between the buttons and the commands. In such cases, use inline code for the commands and italics for the buttons that initiate commands. Otherwise, use inline code for buttons that initiate commands. |
User Prompts (within text) | Bold or Italics | The system will then display
Do you want to continue?
The system will then display Do you want to continue? |
Generally italics is preferred in this situation as it more closely resembles quoted text. |
Information displayed on the equipment or screen | Bold or Italics | As the computer boots up, the digital read-out window will display 8888 . | Generally italics is preferred in this situation as it more closely resembles quoted text. |
Headings | Bold or Italics or Both | If you aren’t using section headers (see below), you can use bold to break apart your PR into sections. |
ch
unit