7 Technical Writing Mistakes to Avoid in 2012
We all make mistakes when we write, but when writing technical documentation, small mistakes can add up to a large consequence – and they could even harm the user or the person on the receiving end. Since it’s about that time to make New Year’s resolutions, it’s a good time to remember common mistakes made in technical writing – and then promise not to make them next year. Here are seven mistakes to be watch for and avoid in the new year.
Technical Writers Should Not…
- Be vague – If your word choices are vague or you use passive voice, your reader may not understand what you mean.
- Avoid templates – When your organization has templates for previous technical documents, use them. This will create congruent and useful documents. Users will get to know what to expect in your documentation.
- Ignore the reader – You always need to keep the reader in mind, who they are and for what purpose they’ll be using your document.
- Write without a plan – Start with a plan in place as to how you might approach the technical writing document, what it should accomplish and how it will look when finished. This will save you time and energy as you begin writing.
- Use contractions – It is true. You need to spell out your words instead of contracting them. Leave contractions for less formal, approachable writing, like blog posts.
- Assume anything – Again, don’t assume your reader will understand what you mean until you tell them what they need to know.
- Edit their own work – Always have another set of eyes look at the document you create so you can be certain your word choices and phrases are effective for a larger audience (outside of yourself).
Everyone makes mistakes, but knowing how to the avoid the most common ones in technical writing is a good way to begin to improve your writing.
Related: 2011 Technical Writing Resolutions (Did You Ascribe to/Keep Any of These?)
What additional mistakes would you urge technical writers to avoid in the new year? Comments are appreciated. Have a happy holiday season from all of us at WAI!