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: "It Ain't Literature, Y'know" From:Sarah Lee Bihlmayer <sarahlee -at- CONTENTMANAGE -dot- COM> Date:Mon, 5 Aug 1996 13:53:21 -0700
Tori writes:
> My problem is this: yesterday, I pointed out to a co-worker that I
> thought the sentence structure he was using in a particular procedure
> was incorrect.
<snip>
> He said, "we ain't writing
> literature, you know." He said that he had given the matter a great
> deal of thought and decided that this was the best way to handle the
> situation. He said that if he wrote,
> Pound the nail into the wall with a hammer.
> someone might use their head to pound the nail with rather than read
> to the end of the sentence. Instead, he prefers to write:
> Using a hammer, pound the nail into the wall.
> or
> Using columnar spacers, place the ....
To me, this construction is somewhat unwieldy. If it's important to
emphasize the use of the hammer, I think there's a cleaner way to express
that. Here's a solution that both of you might be satisfied with:
Use a hammer to pound the nail into the wall.
Your coworker _really_ doesn't trust the audience to have a bit of common
sense if he truly believes they'd use their heads instead of a hammer--but
might as well try to compromise for the sake of harmony.
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-