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.
Sue Gallagher wrote:
> I think that part of the problem you're having with the
> sentence is that it combines two distinct steps (selecting
> and opening). If this is a part of procedural text (steps),
> you may want to break it out.
I have a question about this -- at what point is something so
obvious that you don't want to break it out into two steps?
For example:
1. Move the cursor to the XXX toolbox.
2. Click on the YYY icon.
...
or
1. Click on the YYY icon in the XXX toolbox.
...
Is the first form too obvious? It seems so to me, but then
again, you want to write these kinds of things to the lowest
common denominator, right?
I guess it's a matter of taste, but if anybody has opinions
one way or the other, I'd love to hear them.
--
Glenda Jeffrey Email: jeffrey -at- hks -dot- com
Hibbitt, Karlsson & Sorensen, Inc Phone: 401-727-4200
1080 Main St. Fax: 401-727-4208
Pawtucket, RI 02860
