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: E-Primer From:Mike Pope <mikep -at- ASYMETRIX -dot- COM> Date:Mon, 9 May 1994 13:07:00 PDT
>For example, how else could John Sununu (remember him?) have kept from
>implicating himself or others other than by saying "Some mistakes were
Well, for one thing, maybe he should have been a little more honest about
who was making the mistakes. I believe that one of the criticisms of the use
of passive is precisely that it allows the speaker to "hide". Even so: "Some
of the staff made mistakes", "People made some mistakes", all to avoid the
"I made a mistake".
>How do you say "The program manager window is now displayed" without going
>into gory detail like "Windows now displays the program manager." This
>so bad once, but I'm doing a step-wise manual for a Windows application,
>if every other sentence starts like this, I think it would get tedious to
>read. Plus, I think people just don't care what's causing something to
We err on the opposite pole: active, with the occasional passive as a
breather. In some
instances, active provides necessary clarification: not "An error message is
"Windows displays an error message", that is, Windows as opposed to your
the communications program, or whatever. In cases such as these, I wouldn't
it "gory detail" to name Windows as the agent.
The other prevalent example, and probably the one Andrs was referring to, is
"you can" for passive, as in these examples: "The foo property can be used
the state of the bar" vs. "You can use the foo property to determine the
state of the bar", or
perhaps even "Use the foo property to determine the state of the bar". As
one of my editors
has occasionally scribbled under some of my passive constructions: "Involve
the reader!". The
downside of this type of construction, of course, is "you-can-itis": unless
you look up every
once in a while, every sentence in a paragraph starts out with "you can".