RE: active vs. passive voice

["Leonard C. Porrello" <Leonard -dot- Porrello -at- SoleraTec -dot- com>]

I'm with Nina, and Janice may be right. I don't have strong convictions
one way or the other. It does seem to me that if the user didn't bother
reading both sentences before executing the task, he probably won't go
back to verify what happened against the text anyway. I'd argue, then,
that if he is going to read both sentences at all, it will be before
executing the task. Granted that, would you (Janice) still object to my
grammar?

I do like Janice's suggestion of front-loading warnings. At the same
time, I worry that, being out of context, the reader may not take them
in anyway.

Leonard C. Porrello
SoleraTec LLC
www.soleratec.com
 
 

-----Original Message-----
From: techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+leonard -dot- porrello=soleratec -dot- com -at- lists -dot- techwr-l -dot- c
om] On Behalf Of Nina Rogers
Sent: Thursday, March 27, 2008 2:43 PM
To: Janice Gelb; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: active vs. passive voice

I am a tech writer, so I shouldn't admit this, but ... while I'm pretty
good about reading manuals (and not just looking for how I could have
written them better, ha ha), I'm very bad about clicking buttons as soon
as I read that I'm supposed to click them. For example, if I were
sitting in a military aircraft, reading the manual instruction that
says, "Press the EJECT button to forcibly eject yourself from the
plane," I would never get past "Press the EJECT ..."

Nina Rogers, Technical Writer
Tax Development (Federal)
Drake Software

-----Original Message-----

One could equally assume that readers are doing the
action when you tell them to do so and that they they
read the result after they've performed the action.
(As we all know, sometimes users just perform actions
by guesswork without reading any documentation at all!)

I think it's dangerous to assume that readers read the
explanatory text before they commit themselves to
performing an action. I often ask writers to move any
warning or information that it's important for the
reader to know before performing an action to a location
prior to the imperative instruction to avoid a situation
where the reader clicks first and then finds out later
that this action wasn't appropriate for the situation.

-- Janice
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.