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.
People who need tips on writing clearly also need help with figuring
out which words are needless, so that advice is nearly useless.
Read the text aloud, or better yet, have someone else read it aloud.
If anything sounds awkward or causes the reader to stumble, simplify
until it doesn't.
On Wed, May 19, 2010 at 4:30 PM, Dan Goldstein
<DGoldstein -at- riverainmedical -dot- com> wrote:
> My favorite list is the Table of Contents of "The Elements of Style" by
> Strunk and White. These precious gems include:
> "Use the active voice."
> "Put statements in positive form."
> "Use definite, specific, concrete language."
> And the three most beautiful words in the English language:
> "Omit needless words."
> "When [Will Strunk] delivered his oration on brevity to the class, he
> leaned forward over his desk, grasped his coat lapels in his hands, and,
> in a husky, conspiratorial voice, said, 'Rule Seventeen. Omit needless
> words! Omit needless words! Omit needless words!'"
>> -----Original Message-----
>> From: Richard Mateosian
>> Sent: Wednesday, May 19, 2010 3:55 PM
>> To: TECHWR-L
>> Subject: Writing clearly
>> I'm putting together a list of tips for writing clearly (for
>> example, ensure that your pronouns have unambiguous
>> antecedents). Contributions are welcome.
>> I posted a similar request on the copyediting list. I suspect
>> that this list will produce different suggestions. ...RM
Gain access to everything you need to create and publish documentation,
manuals, and other information through multiple channels. Choose
authoring (and import) as well as virtually any output you may need. http://www.doctohelp.com/
- Use this space to communicate with TECHWR-L readers -
- Contact admin -at- techwr-l -dot- com for more information -
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-