Break information into sections
Business readers skim technical reports to find sections of interest to them. Structure your report with that in mind: think in terms of sections instead of long narrative passages that act as discouraging walls of text. Short paragraphs in logical groupings allow readers to find the information they need to do their own work quickly and easily.
To meet the needs of technical and non-technical readers alike, structure the report so that the main body isn’t bogged down with extensive technical details, such as spreadsheets or functional specifications. Instead, refer interested technical readers to appendices organized by data type and write a detailed table of contents so they can easily find what they’re looking for.
Use subheadings to highlight important concepts
Use a system of headings and subheadings to help readers skim (they’re going to do it anyway) as I’ve done with this article. Load your headings and subheadings with a distilled version of that section. A well-written set of headings and subheadings provides some readers with enough information to do their jobs—and they value the effort you made to make that possible.
Information-rich headings also help the reader navigate a report to quickly find a section of interest. Use verbs in your headings to energize them and make them concise.
- Recommendation to Upgrade Existing Laptops
- Committee Approved Pay Raise
- How to Prepare for Meetings
Steer clear of unnecessary jargon
Jargon is industry- and discipline-specific shorthand that saves time among members of that industry or discipline, but it can leave non-technical readers confused.
Acronyms are one kind of jargon. They can be handy space savers for readers who can crack the code. If you’re unsure if all readers of your report know an acronym you want to use, define it with the first use.
The AML (anti-money laundering) department is being relocated to Halifax.
Sensitize yourself to your own industry or discipline jargon. Try the neighbourhood cocktail party test: would you use that term or phrase with friends? If not, it’s probably jargon. Share the secret handshake in context. For example:
Heavy water, which contains significantly more hydrogen and is 10% denser than ordinary water, is used as a moderator in some reactors.
Last words
Practicing empathy for your reader’s needs results in technical reports that meet their needs, and that means improved information flows through the organization. Skilled report writers know it’s time well spent.