Flame me, I'm Italian

Subject: Flame me, I'm Italian
From: Glen Accardo <glen -at- SOFTINT -dot- COM>
Date: Wed, 13 Jul 1994 14:23:21 CDT

I write lots of manuals for techno-dweebs. Consequently much of what I write
involves "instructions" such as:

- A requires module B in C mode.
- D provides the input for E.
- etc.

Would statements such as the above be better written as actual instructions?
That is "To make A work, start module B in C mode" or "Take the results of D
and input them to E."

For user's manuals, I'm very careful to write _instructions_: do A, do B,
then do C, and I try to avoid constructions such as the above. Is the same
style as necessary for "high-end" users?

glen accardo glen -at- softint -dot- com
Software Interfaces, Inc. (713) 492-0707
Houston, TX 77084

Nuke the unborn, gay whales for Jesus. Flames to /dev/null.

Previous by Author: Re: Okay, whaddaya call
Next by Author: Re: want v. wish
Previous by Thread: Please Come Visit Austin STC
Next by Thread: Flame me, I'm Italian

What this post helpful? Share it with friends and colleagues:

Sponsored Ads