Re: Active versus passive

Subject: Re: Active versus passive
From: John Posada <jposada01 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 20 Dec 2000 10:53:22 -0800 (PST)

> > > > Click the Report button. The report is generated.
> > > > Is this also unclear?
>
> I wrote:
>
> > > It is only somewhat unclear, but worse, it is not
> > > as helpful as it could be.
> >
> John Posada wrote:
>
> > How is it somewhat unclear? "Do an action. This is the result."
>
> It is somewhat unclear because you have only
> hinted at the causal relationship between the two events.

That's a joke, right?

> If you state the relationship explicitly (as in "to generate
> the report, click whatever") it will be MORE clear. Therefore,
> it is somewhat unclear as you have written it.

I apprciate you playing devil's advocate. However, I'm not writing
for someone out of the jungles who has never seen the written word. I
think for enough of a majority of people that I care about, if they
cannot make the tie between the two sentences, then, yes, they are
too stupid to use the software. There is such a thing as writing for
the user, and writing for someone who is too dense to be a user.
Chances are, if they cannot make the relationship between the two
sentences, it doesn't matter, because they didn't know how to turn
the computer on.

I write instructions to be clear to the level of user our software is
targeted and I try my best to be as clear as possible. However, I
don't always write so that 100% of the people know WHY something
happens. I write so they can get something done. Do I care that they
don't know the motivation of the button and why it wants to create a
report? nah...I want them to know that if they press a button and
instead of a report being generated, their coffee pot turns on, that
something is wrong.

=====
John Posada, Senior Technical Writer
"I'm not flying. I'm falling...with style."
-- Buzz Lightyear
mailto:john -at- tdandw -dot- com, 732-259-2874

__________________________________________________
Do You Yahoo!?
Yahoo! Shopping - Thousands of Stores. Millions of Products.
http://shopping.yahoo.com/

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-based Help with Macromedia Dreamweaver! (STC Discount.)
**NEW DATE/LOCATION!** January 16-17, 2001, New York, NY.
http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.

Take XML and Tech Writing courses online! Our instructor-led courses
(4-6 hrs/wk) give you "hands on" experience at your convenience. STC members
get 20% off! http://www.online-learning.com/index.html.
---
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: Other proposals
Next by Author: Re: Indexing verbs?
Previous by Thread: Re: Active versus passive
Next by Thread: Re: Active versus passive


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


Sponsored Ads