RE: active voice v. passive voice

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


Jane writes:

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
can't
recall being given any advice on writing in English lessons (that would be
about
free expression and, er, stuff) but in Chemistry we were taught to always
write
things like "The test tube was held over the bunsen burner and it was
observed
that the liquid changed colour. It was further observed that the
experimenter
burned his fingers" etc. I think the intention behind this kind of thing
was to
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
instructions
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
objective.
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
at
the end though with something pithy like "You can create such a polygon
mesh using the LiPrimitiveCreateMesh API function.".

Cheers

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.


Previous by Author: RE: release notes question
Next by Author: Usability
Previous by Thread: active voice v. passive voice
Next by Thread: Re: active voice v. passive voice


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

Sponsored Ads


Sponsored Ads