Style reminders
Paul W. Frields
stickster at gmail.com
Sun Aug 5 15:30:26 UTC 2007
I'm doing some editing and cleanup of the AskFedora column, and wanted
to remind contributors about our Style Guide:
http://fedoraproject.org/wiki/DocsProject/StyleGuide
Please try to use *active voice* wherever possible. The following is
passive voice, and is incorrect:
"The formation of a Foobar SIG was announced."
The resulting tone implies that the author is hesitant to attribute the
decision to a specific party. One of the most refreshing ethics about
FOSS communities is that we do work publicly and we take responsibility
for what we do and say on a regular basis. As a result, the active
voice communicates our message more clearly:
"FESCo announced the formation of a Foobar SIG."
Other side benefits of active voice are easier readability and
translatability/localization.
--
Paul W. Frields, RHCE http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Project: http://fedoraproject.org/wiki/PaulWFrields
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
Url : http://lists.fedoraproject.org/pipermail/news/attachments/20070805/5b03732d/attachment.bin
More information about the news
mailing list