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.
Janice wrote:
> Nancy Riccio <ptcs -at- plateautechcomm -dot- com> wrote:
>
> > OK, we all know that it's better to use active voice whenever possible.
>
> Actually, that's not entirely true. *Most* of the time,
> especially when providing instructions, active voice is
> better than passive voice. However, passive voice is fine
> in situations where the actor is unknown ("The file was
> corrupted") or if the actor would be redundant or is obvious
Danger, danger, danger! Obvious to whom?
There's the rub.
The trap that so many novice writers fall
into is to assume that what is obvious to
them is obvious to everyone.
There's not likely to be a problem with
comprehension in the case of "the results
are displayed" -- but it is a slippery slope
and soon you're into "the data is entered"
territory where things get very murky very
quickly.
My advice is to save yourself the time it takes
to go around asking people what is and what
obvious to them. Don't risk it.
NEED TO PUBLISH FRAMEMAKER CONTENT ONLINE? "Mustang" is a NEW single
sourcing tool for FrameMaker that lets you easily publish your content
online. No macro language required! http://www.ehelp.com/techwr-l3
Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See www.mercer.edu/mstco or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-
---
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.