TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
In my experience, the following syntax works well:
1. Choose File>Save As.
2. Select Rich Text Format *RTF in the Save As File Type combo box (I
believe "combo box" is technically the correct term though many writers use
drop down list).
Using the term "Choose" for menu options clearly distinguishes menus from
combo boxes and list boxes where users must literally "select" an item. You
probably don't' need to follow your instruction with menu option because the
vast majority of users know how to use Windows menus.
Letty Smith asked:
Here's a question that has been raised in our department - what's the best
way to describe in writing to the user that they should select a particular
menu and option? We try to use a graphic when possible, but sometimes it
isn't possible, or doesn't fit in the documentation. So ... which is
1. Select the File -> Save As... menu option.
2. Select the File - Save As... menu option. (n-dash)
3. Select the File -- Save As... menu option (m-dash)
4. Select the File > Save As... menu option.
5. Some other way?
Does it make a difference if it is a three-deep menu option? (i.e. Select
the File -> Save As ... -> Keenfile Graphic menu option.)