Passive voice == evil.
Paul W. Frields
stickster at gmail.com
Sun Dec 23 20:11:42 UTC 2007
I have looked over a wide variety of random insertions in some of our
docs and see a lot of passive voice being used. Please try to use
active voice in docs instead of passive voice wherever possible. The
folloiwng is an example of the difference between active and passive
PASSIVE (incorrect): In Fedora 8, a new tool called "FooBar" has been
introduced to help users create foobars.
ACTIVE (correct): Fedora 8 includes a new tool called "FooBar" that
helps users create foobars.
Generally, passive voice includes unnecessary forms of the verb "to be,"
such as "has been," "is," or "was." Passive voice is unnecessarily
difficult for translators in some locales to address.
Here is one way to test for unnecessary passive voice. If the sentence
includes a form of the verb "to be," does it:
(A) describe an *attribute* of the sentence's subject, or
(B) describe something that happened?
If the answer is (B), the sentence probably uses passive voice and
should be reworded.
Today's English composition tip is brought to you by the letter "M" and
the number 4. :-)
Paul W. Frields, RHCE http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Project: http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/docs/attachments/20071223/03d254e2/attachment.bin
More information about the docs