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: Prompt as ask From:mmorgan -at- intrepid -dot- cdg-hargray -dot- com To:techwr-l -at- lists -dot- raycomm -dot- com Date:Tue, 14 Sep 1999 07:36:32 -0500
Tom Murrell asked:
>I'm interested in how others react to this observation. I'm also
interested
>in other words or phrases we might use to distinguish between volitional
>acts, which might be committed by human beings, and pre-programmed acts,
>which are programmed into our systems.
Just yesterday I came across a phrase such as this while editing one of
our manuals. The writer used the phrase:
"If this field is left blank, the job will run when the system can schedule
it."
When I read this, I got the image of a little gnome sitting inside the
AS/400
with a notebook, taking calls and scheduling appointments. OK, so I have a
slightly overactive imagination, but this phrase really did not sit well
with
me. So, I changed it to a more passive statement:
"If this field is left blank, the job will run when the system is
available."
Side note: Here's another one that really cracked me up. A developer sent
a document describing how a telephone circuit should be set up using our
software. This one's a doozie:
"When facilities cross into other routes, they should only penetrate the
new route
by one piece of equipment."
Gee, I didn't know facilities had the ability to penetrate! Do you suppose
the
second and third pieces of equipment might be jealous of the first piece
of equipment? ; )
Melissa Morgan
mmorgan -at- intrepid -dot- cdg-hargray -dot- com