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.
Though I know the implementation of policy many times doesn't reflect the
policy's intent, since the early '80s the U.S. military has instituted
policies of effective writing.
EXCERPT:
(h) Choose words carefully. To communicate
effectively, use simple, direct words. For example, staff
car is almost always better than administrative vehicle
and M16 better than individual weapon....
(i) Use personal pronouns whenever possible.
When writing to a specific audience, as in a trainer's
guide, use the second person pronoun you....
...
(k) Be clear. Avoid sentences like the follow-
ing which, even when reread, may not be clear:
The fewer the number of weak links and the less the
weakness of any one link, the longer is a unit able to
function usefully (with, at least, some effectiveness).
Knowledge of support-level partial and complete
operations by using units expedites setting up the
facility and enables more effective decontamination
of personnel and equipment.
joe
Joe Sokohl
Manager of Documentation
Campbell Software, Inc. http://www.campbellsoft.com
"It ain't the end of the world
It's just the wreck of the Barbie Ferrari."
_______John Hiatt
The opinions expressed in this mail are mine.
They don't necessarily represent Campbell Software or any of its
affiliates.
TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html