: Should you emphasise text within quotation marks? e.g. Bold: Click "Setting" then click "Options". Italic: Click "Setting" then click "Options". Or even underline? Or none quotation marks?
e.g.
Bold:
Click "Setting" then click "Options".
Italic:
Click "Setting" then click "Options".
Or even underline?
Or none quotation marks?
Click Setting then click Options.
Which is better/correct/preferred?
More posts by @Turnbaugh521
: Can I write a Hero's Journey without them leaving an Ordinary World? (Monomyth template) I was recently taught about the Hero-Journey template Instead of the Hero leaving the Ordinary World, can
: Should the amount of work I write as a high school senior be a concern when choosing a career? I attend an arts school called ACES Educational Center for Arts, and this is my third year
3 Comments
Sorted by latest first Latest Oldest Best
According to the Microsoft Manual of Style for Technical Publications, for commands on menus and buttons:
Bold in procedures; capitalization follows that of user interface.
This is the convention we use for technical documentation in my company, as well, and correlates to your last example:
Click Setting then click Options.
Underlines are only for links; don't use them in copy for anything else (outside certain legal contexts).
Either use bold/italic or quotes, but not both. It's redundant. Which one you choose will depend on what's easiest to read. If you have many of these steps and commands, I would go with a bold or italic, as too many quotes gets visually exhausting.
I have seen bold and I have seen inverted commas. I haven't seen combinations.
Simply say which you are going to use at the beginning. For example, I just found this in 'Beginning Android Application Development': "Code is presented in two different ways: We use a monofont type with no highlighting for most code examples. We use bolding to emphasize code that is of particular importance in the present context." (I haven't included their formatting.)
I realise that this code rather than which menu item to choose, but I think there are a lot of similarities.
Terms of Use Privacy policy Contact About Cancellation policy © selfpublishingguru.com2024 All Rights reserved.