10 DIAGRAMS, LISTS AND GRAPHICS

Technical writing is all about clarity and efficiency. Sometimes the clearest, most efficient way to present information is to use fewer words in a more effective way. That might mean presenting the information as a numbered or bulleted list, or as an infographic. Or it might mean putting the information across in a flow chart.

The items I’ll describe in this chapter are like salt. Used sparingly they can bring out the flavour of your writing and enhance what you’ve created. Use too much and they’ll overwhelm it and possibly ruin it. As ever, less is more.

LISTY BUSINESS

From our childhood letters to Santa to the to-do lists pinging on our phones, we use lists for all kinds of things. There’s a good reason for ...

Get Technical Writing for Business People now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.