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 "appears" at work From:Chuck Martin <techwriter -at- VNET -dot- IBM -dot- COM> Date:Fri, 15 Jul 1994 10:27:12 PDT
Arthur Comings changed
The Line Name dialog box appears to allow you to specify the seismic
line to wish to edit.
to
MaxPro displays the Line Name dialog box, which you use to specify
the seismic line you want to edit.
While "successfully" correcting the ambiguity of "appears," I think
the construction (both old and new) suffers from containing part of
two steps. The first part is the result of a previous user action.
In a procedure, I'd want to put that result immediately following.
Then the second part would become the next step, something like this:
#. (User action: From the Edit menu, choose Line Name.) The Line
Name box appears.
#. Select the seismic line you want to edit, then press ENTER.
(Part of this step may have to describe how the selection process
takes place in the user's environment.) The seismic line
is highlighted, and the Edit screen appears.
I think this one-action-one-result works well for procedures. Any
thoughts? Have I opened up a major can o' worms?
Chuck Martin
Information Developer, IBM
techwriter -at- vnet -dot- ibm -dot- com
