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: active voice v. passive voice From:Chris Gooch <Chris -at- lightwork -dot- co -dot- uk> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Wed, 21 Feb 2001 12:09:47 -0000
A co-worker has gone through a manual and, among other things, carefully
changed active voice to passive voice.
I think people tend to think this way because of badly remembered lessons at
school, usually from science teachers. At my school (Britain in the 80s) I
recall being given any advice on writing in English lessons (that would be
free expression and, er, stuff) but in Chemistry we were taught to always
things like "The test tube was held over the bunsen burner and it was
that the liquid changed colour. It was further observed that the
burned his fingers" etc. I think the intention behind this kind of thing
give the appearance of objectivity.
What people remember though, is that that is how you should write official
sounding stuff, and so think that "Using tongs, hold the test tube over the
bunsen burner until the liquid changes colour" is somehow over-familiar.
Which is unfortunate, since if the teacher had written this in his
to the class, I would not have burned myself. :-)
Perhaps an example like this would clarify things for your co-worker. The
intention of your writing is (probably) to instruct users, not to sound
That said, there are cases where a mixture of voices is appropriate; for
example in a longish section about the topology of polygon meshes
and their use for approximating non rational B-Spline surfaces, complete
with the maths, it's gonna creep in. I like to bring it all back to Earth
the end though with something pithy like "You can create such a polygon
mesh using the LiPrimitiveCreateMesh API function.".
Christopher Gooch, Technical Author,
LightWork Design Ltd., Sheffield, England.
chris -at- lightwork -dot- co -dot- uk www.lightwork.com
Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17) http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Sponsored by ForeFront, Inc., maker of ForeHelp Help authoring tools
for print, WinHelp, HTML Help, JavaHelp, and cross-platform InterHelp
See www.forehelp.com for more information and free evaluation downloads
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.