TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
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 07:53:08 -0800 (PST)
Hi, Michael...
These are Help Topics. The topic that this might go under would be
called:
Create a Report
The step below might be one of 2, 3, 7, or more steps, starting with
what variables you would need to set to create the right report. I
know that taking it out of context makes it hard to visualize, but
trust me, if the user didn't know what what was going to happen when
they clicked the button, we've got worse problems that
active/passive.
--- Michael West <mbwest -at- bigpond -dot- com> wrote:
> John Posada wrote:
>
> > Click the Report button. The report is generated.
> >
> > Is this also unclear?
>
> It is only somewhat unclear, but worse, it is not
> as helpful as it could be.
How is it somewhat unclear? "Do an action. This is the result."
Besides...as I explained to someone else last night, while this
example is somewhat simplistic, it gives the model that I follow.
The action part might be one or two sentences. The result part might
be multiple sentences, might be a screen shot, might be anything.
However, by following this model, I can structure any complex set of
instructions into a series of steps, showing the action and the
result. At least the reader knows what to expect each time, and when
explaining a very complex process, I think consistancy is as/more
important than the structure opf an individual step.
> "To generate the report, click the Report button"
> is better because it tells me the result BEFORE
> I perform the action. After I've clicked it, who cares?
> It's too late.
>
> A lot of fretting over "rules" of usage turns out to be
> chasing red herrings. Focus on clarity, directness,
> and helpfulness instead of "rules", and you'll be
> right. And being right is much better than being
> "correct."
__________________________________________________
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.