RE: active vs. passive voice

["Paul Kretschmer" <Paul -dot- Kretschmer -at- YARDI -dot- com>]

We had some anti-appears people in our group, but we overcame them.

Their argument against "appears": it made the software sound magical.  

(But marketing people think that software is magic.)

--
Paul Kretschmer | Technical Writer, Documentation
toll free 800.866.1124 x191 | local 805.699.2040 x191 | fax 805.699.2044
paul -dot- kretschmer -at- yardi -dot- com | www.yardi.com


-----Original Message-----
From: Nancy Allison [mailto:maker -at- verizon -dot- net] 
Sent: Thursday, March 27, 2008 8:06 AM
To: Michelle Vina-Baltsas; Paul Kretschmer; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: active vs. passive voice

Hi, Michelle. Yes, "is displayed" is passive, but it is perfectly
acceptable in this context. The emphasis in this kind of procedural
explanation *should* be on the action, not on the doer of the action. 

People who insist that the passive voice is never acceptable are going
overboard. 

As my youthful hero Ralph Waldo Emerson wrote, "A foolish consistency is
the hobgoblin of little minds."

(And, as Paul K. points out, "appears" works just as well -- unless you
have an anti-"appears" obssessive in your doc group. I have worked with
one or two, and the discussion can get ugly!)

--Nancy

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or 
printed documentation. Features include support for Windows Vista & 2007 
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/ for more resources and info.