Say Less, Offer More in Technical Writing
It’s common to find technical documents that are more than a few hundred pages. That alone can cause a reader to step away, quickly, from the document. While there are cases when more details are necessary, some technical writers have stopped worrying about the reader and about how bloated texts can lead to confusion. With more concise writing methods, technical writing becomes more brief, but no less effective or accurate.
To help create the most concise technical document:
- Avoid extra words – If you include extra words, you’re not adding value to a technical document. Include only the words and details that are relevant to the user’s needs.
- Consider your audience – When an audience already has a certain level of experience, they don’t need to hear the beginner information.
- Use simple words – Though there are places where longer words are needed, when a simpler word can be used, it should be used.
- Don’t repeat yourself – While it’s tempting to say that you’re referring back to another section, either reference that with the section number or don’t reference it at all. The idea is that the reader will have already read that prior section, so referencing it again is redundant.
Some might call this ability to say less and offer more: brevity with clarity. Say what you mean and only what you mean, keeping the reader in mind, and avoiding unnecessarily complicated words. Your reader deserves technical writing that gets to the point.