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.
<snip from Jonathan B. Horen>
>
>When you press the OK button, page 2 will be displayed, as shown in Figure
>23-45 on page 23-400.
Use ACTIVE voice, John. "...button, page 2 appears..."
</end snip>
Jonathan,
Just curious, why is the passive voice evil in this circumstance? I would
agree with you if (the other) John had originally said, "The OK button
should be pressed to display...."
But, "Press OK. Page 2 is displayed in the Fribbitz window" or just "is
displayed" does not seem (to me, anyway) to add to the reader's cognitive
load. In fact, it actually emphasizes what the user will see (page 2) when
they press the button, and de-emphasizes whether it appears or is displayed.