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.
> 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 ....
> Whether his sentence structure is correct or not, is one issue. For
> me, the more important point was his statement, "this ain't
> literature, you know." Its not the first time he's said it either.
I'm not sure why this particular structure strikes you as incorrect, unless you
are mistaking the gerund phrase for a dangling participle (in which case the
modifier would address something other than the subject of the main clause). In
fact, the first option is definitely ambiguous. The preposition "with" can have
more than one meaning here. Is the hammer physically "with" the wall, or is it
being used by a person? But, as you noted, this is a different issue than your
primary concern.
> My question is this, to anyone who cares to answer, either privately
> or to the list in general, is he right? Am I trying to turn technical
> writing into literature when I demand that the writing not become
> slipshod? What say you? I would genuinely like to hear.
He's right that most technical writing isn't great literature (yet--let's not
forget Chaucer's treatise on the astrolabe). However, if he's trying to suggest
that technical writing doesn't have to be as clear or precise as literature,
he's misinformed. Because technical writing is primarily affective (has
instruction as its end goal or drives toward informing an audience that has
ts own end purpose in mind), technical writers should be far more concerned with
clarity. If our aim were to write great literature, we'd probably be working
more with narrative, dialogue, and perhaps some experimental techniques.
(Hmmm--stream of consciousness software instruction?)
Bill Burns
Assembly Training and Documentation Supervisor
WBURNS -at- MICRON -dot- COM
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-