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.
Select the File/Open menu item.
----------
From: Karen_Mayer.TOUCH_TECHNOLOGY
To: Multiple recipients of list TEC
Subject: Re: Improving the clarity
Date: Monday, August 14, 1995 1:04PM
I have to say that an instruction like
- To open a file, select File / Open from the main menu.
is easier to read and follow than
- To open a file, select Open from the File menu.
I was going through the tutorial in the FrameMaker manual (looking at our
demo version - YAY!), and the whole manual is written with the menu name
last. This is really annoying, because sometimes the thing you're looking
for is nested several layers deep, so you'd get to a sentence that says
Select Headers/Footers --> Insert Page # from the Format menu.
I have to scan to the end of the sentence to find out which item I should
be clicking *first*. I much prefer to list the items in the order the
user will be clicking -- and as a user, I much prefer to read
instructions listed in this way, too.
