Technical Writing Tip – Visual Analogies – How and When to Use Them

  • Post author:

Written by John Lafferty

John Lafferty, Northridge Quality and Validation
Read time: 2 minutes
For those of you who have been following our Technical Writing Tips of the Month, you will be familiar with the “Outside-In Approach” discussed in the Tip of the Month Outside In Approach.  In that tip, we discussed the 5 steps to using the “Outside-In Approach”. The second step of this technique is to decide what you need to communicate to make the message understood. Using visual analogies and symbols can be an excellent way to make your message understood and therefore I recommend that you read an article written by Anna Vital of www.adioma.com
This article is an excellent explanation of how and when to use visual analogies. The article is a valuable resource to keep on hand when writing technical documents. Below we have summarised the key points and given a link to the full article.

60% of us are visual learners

The author begins by stating that “about 60% of the world population are visual learners. How do you talk to us through images without translating them into words? Use ubiquitous visual symbols and analogies.”

70 types of visual symbols explained

She then explains 70 types of charts, diagrams, ordinary and abstract analogies and how best to use them. Best of all, she provides a link to an example of every type.

5 Principles for Finding the Best Analogy

Ms Vital gives 5 principles for finding the best visual analogy as follows:
1. It looks familiar to most people

2. It has a structure

3. It matches your narrative’s structure

4. It is visible in the body of the text (rather than in an appendix)

5. It is visual (something that is easy to see)

Conclusion

She concludes her article as follows: “what matters is a strong connection to a mental image. This connection explains the information you are visualizing without you having to tell it, you have no space to do that in a visualization.” (the author means that the information is explained without the use of text)    
Read the full article here

Technical Writing Skills Training Course

technical writing online virtual course

Northridge Quality & Validation and our training partners, SQT Training are running a comprehensive training course on Technical Writing Skills. Note: This course will be delivered via a Virtual Classroom (not in person).

Course Title: Technical Writing Skills Course

Course dates and booking: Course booking and future course dates can be found on the SQT Training website.

Course Content: Our structured, practical program will help you to identify the key message you need to deliver in your written document and to deliver it clearly and concisely in a way that will ensure it is understood.

Ongoing Updates: Sign up for our newsletter here if you would like to receive updates to your inbox

About John Lafferty – Course Tutor

John Lafferty is the Technical Writing Skills course tutor at SQT Training Ltd. He also delivers courses in areas such as Process Validation, Software Validation, and Risk Management for Medical Devices. John runs a Quality Management Consultancy, Northridge Quality and Validation Services, specialising in the area of Medical Device and Pharmaceutical Quality Systems.