Re: active vs. passive voice

Subject: Re: active vs. passive voice
From: Peter Neilson <neilson -at- windstream -dot- net>
To: Gause_Brian -at- emc -dot- com
Date: Fri, 28 Mar 2008 20:29:12 -0400

Gause_Brian -at- emc -dot- com wrote:
> This is a lot of discussion for something that should be quite simple.
>
> I would rewrite this sentence:
> 1. Click <New Entry>. The New Entry window will appear.
>
> Like this:
>
> 1. Click <New Entry> to display the New Entry window.
>
> Then it's not passive voice. In fact, it's better! It's a command.

Oh, no! I'm being drawn into this already too far over-drawn-out discussion!

The user does not want to display a New Entry window. He could not care
less about the damned window. He wants to change something, and he's not
quite sure what. Indeed, he's gotten to where he is by hunt-&-click
methods, hoping like heck that he discovers something useful. He's
turned to the User Manual that is masquarading as the Help Files as a
last resort. He thinks he wants to add an entry to the master record
table, but can only find how to make a New Entry, and it looks as if
it's going to go into the New Entry table.

He (and it's he, not she--wimmins would have asked real people for help
by now) has clicked on the New Entry button twice already. He's
double-clicked on it, too, and seen two New Entry windows appear on top
of each other. He wishes whoever wrote the instructions actually tried
to do some of the end-user tasks.

Won't I ever learn to shut up and leave these preaching-to-the-quire
discussions alone?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.


References:
active vs. passive voice: From: Michelle Vina-Baltsas
Re: active vs. passive voice: From: Mike Starr
Re: active vs. passive voice: From: Suzette Leeming
Re: active vs. passive voice: From: Bastette
RE: active vs. passive voice: From: Leonard C. Porrello
RE: active vs. passive voice: From: Fred Ridder
RE: active vs. passive voice: From: Leonard C. Porrello
RE: active vs. passive voice: From: McLauchlan, Kevin
RE: active vs. passive voice: From: Gause_Brian

Previous by Author: Re: Pages Per Day
Next by Author: RE: Checklist for Reformatting
Previous by Thread: RE: active vs. passive voice
Next by Thread: RE: active vs. passive voice


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


Sponsored Ads