== 10 Things You Must / Must Not Do ==
- Always ask yourself, “How will this read to outsiders.”
- Never assume your document will be read only by people for whom it was intended.
- Always use the styles, templates, and font families specified by Publications and Marketing that provide a consistent “corporate voice.”
- Never invent a new style for a single document.
- Refer to the Style Guide. The Style Guide is your friend. It saves you from having to make a dozen nit-picky decisions every day.
- Never attempt humor in corporate documents. When humor misfires, it makes everyone look a chump. (“Dying is easy, comedy is hard.” -the last words of Sir Donald Wolfit, British actor and director)
- Prefer the active voice.
- Don’t count on mechanical tools to relieve you of the burden of proofreading your document for sense and correct usage. If machines could write, they would already have your job.
- If possible, set a piece of writing aside for a short period before proofing—this separates you from the “heat of composition.”
- Remember that there is always one more typo.
2 comments:
When in Doubt crack Elements of Style and remove all doubt.
Alas. This is not English, this is Technical Writing. The rules are much more picky. Such as:
Do you include a comma in the penultimate element of a series contained in a sentence?
Or:
Do you describe a screen action as "drag and drop" or just "drag"?
The fact that I can deal with this stuff, indeed, that I have been put in charge of this stuff, must cause those that have never experienced my obsessive-compulsive side to scratch their heads in wonder.
Post a Comment