Digital Marketing admin  

The ABC’s of Technical Writing: 4 Traits Technical Writers Should Know

Writing a technical report is often a real challenge for many technical professionals. Research, research, or design is why you’re doing what you love to do… but then you have to write a report. And that has the potential to be the weak link. But there are some characteristics of technical writing that are essential, whatever your field or organization. I like to remember them as the ABCs of technical writing: precision, brevity, clarity, and simplicity.

  1. Accuracy: Accurate reporting of your findings; accurate presentation of the facts; accurate representation of your findings, according to the methods you have used. Be sure to clearly indicate where you have expressed an opinion, rather than a particular result of your research. As much as possible, provide specific information rather than generalizations.
  2. Brevity: Try to keep the document as short as possible – readers short on time will appreciate this. Consider placing background and supporting information in an appendix, footnote, or reference at the end of the note. As much as possible, keep sentences short (15-20 words works well for most readers), with only one idea expressed in each sentence.
  3. Clarity: Use familiar vocabulary and constructions (make sure you have thought about who will be reading your report and be prepared to explain potentially unfamiliar words, perhaps as a glossary, footnote, or endnote). Be consistent with your terminology, abbreviations, and presentation of figures, tables, illustrations, etc. Consider using tables, figures, graphs, illustrations to prove your point…as ‘they’ say, a picture saves a thousand words. Remember that jargon (specialized terms used in your field) excludes those who are not familiar with those words. Use precise words: Your readers don’t like having to decide if a word has a slightly different meaning in different contexts. A useful technique is to use bullet points or numbered points to express complex ideas (if your discipline or organization allows it).
  4. Simplicity: It’s about expressing your thoughts simply, not simplifying your work. Remind your readers: you want to show them the value of your work, not how good a writer you are. Content is more important than fancy writing. Verbosity makes it difficult for your readers to understand. Make sure you have thought through the logical progression of your report. Plan the structure of your document so that you lead your readers to the conclusion you have reached. The inherent simplicity of using Plain English (active voice, sentences of reasonable length, intelligent use of specialized terms, no verbosity) will serve you well.

Familiarize yourself with the ABCS of technical writing. Remember that you’re writing to make your readers say, ‘That’s great work,’ not ‘That’s great writing, but I’m really not sure what it’s about.’

Leave A Comment