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.
Subject:Re: Improving the clarity From:Pat Madea <madea -at- MMSI -dot- COM> Date:Mon, 14 Aug 1995 13:47:54 MST
>From: Karen_Mayer.TOUCH_TECHNOLOGY
>
> 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, ....... <snip and deleted>......
Exactly, exactly, EXACTLY! I, too, find FM's manuals (I use FM4 for
Unix) extremely frustrating for just that reason. But, at least the
FM manual writer(s) were consistent in their structure, so I got into
the habit of going to the end of the sentence first and jumping around
from there.
