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. Passive standards From:geoff-h -at- MTL -dot- FERIC -dot- CA Date:Fri, 19 Jan 1996 11:51:20 -0600
Here's an approach that mixes active and passive voice but
minimizes the passive: use a bulleted (or other) list. Use
the passive in a brief phrase that introduces the list,
then active voice in each list item. For example:
Writers of standards shall:
- use active voice everywhere,
- read techwr-l religiously, and
- hire a good editor.
A few significant warnings:
1. Never write lists in the negative; that is, don't
preface the list with "...shall not". [If you insist,
"Always write lists in the positive." <grin>] If you do
this, there's a great risk that readers will forget the
"not" by the time they reach the end of the list; worse
yet, they may never even read the preface, believing that
it probably says "shall blahblahblah". This can have
unpleasant consequences if the last point in the list is
(for ex.) "work with the device plugged in to avoid
electrocution".
2. If you split the list across two pages or columns,
repeat the introductory phrase at the top of the new
page/column, with some indication that you're continuing
from a previous list. Repetition ensures that the context
is present, and "continued" ensures that readers know the
list begins earlier. Some combination of the asterisked
elements in the phrase "*(continued from previous page) In
addition,* users shall:" works well in most cases.
3. Watch the parallelism. Don't mix "do this" and "don't do
that" in the same list, unless you use a warning box of
some sort (e.g., an icon followed by the explanation) to
alert the reader that you're changing from a do to a don't.
A few other gotchas that other folks will probably point
out, but the overall technique works.
--Geoff Hart @8^{)}
geoff-h -at- mtl -dot- feric -dot- ca
Disclaimer: If I didn't commit it in print in one of our
reports, it don't represent FERIC's opinion.