Wednesday, July 20, 2005

"Commas are a sign of weakness"

I'm very nearly certain that some of my writers and some of our clients went to the same training ground as the O. Pine, who, in his breathtakingly stunning Tech Writer's Style Guide neatly sums up the prevailing linguistic wisdom in the field.

On bulleted lists
There is simply no way to include too many bulleted lists. Bulleted lists make everything clear, because it takes a complicated sentence with too many commas and turns it into a simple and precise enumeration of critical points. Use as many bulleted lists as possible, because the more often you use them, the more clear your document becomes.

On commas
Commas Commas are a sign of weakness. Good sentences are clear without the use of commas. Bad sentences use commas as a crutch to help readers limp along. Rewrite any sentence that requires the use of a comma. If all else fails just take the commas out of the sentence without changing anything else. Occasionally sprinkle a few commas into the document at random just to keep the English-major weenies happy.

Concerning "impact"
This is a wonderful word. Use it as much as possible! Any time you have an opportunity to explain that an action causes something to happen, be sure that it was an impact (you can use it as a verb, too, by explaining how an action impacted something).

It's all so much more clear now.

No comments: