Can Information Mapping help us write better technical documentation?
by George Lewis
by George Lewis
In this article
Style guides
Mapping method
Applying mapping
About the author
Making large amounts of information comprehensible and easy to digest is the bulk of what we do as technical communicators. But this is a task for which most people have had no formal guidance.
Information Mapping is already used in the world of business process documentation to break down and re-structure information so that employees do their jobs better. Can a similar approach be taken for technical product documentation?
Currently, writers take information and attempt to put it into a useful form using guidance from style guides, content models and common sense. This makes it hard to standardise content across technical writers, or to have an objective measure of quality.
As both a course and a standard, Information Mapping presents a systematic approach to organising and presenting information that is based on the needs and expectations of the reader. So far, so good. When it comes to technical product information, we need to define how to structure and present information and graphics, and how to make stylistic choices for both writing and layout.
The Information Mapping course covers a number of topics from document design to how to write definitions, and describes a number of hard-and-fast rules for documentation. In some cases, we can bend these a little for technical documentation, while still sticking to the core principles:
As an example of how Information Mapping principles can be applied to technical product documentation, we can look at chunking.
A ‘manageable chunk’ is defined as a group of 7±2 items when reading from paper, or 5±2 when reading from a screen. This is based on research into short-term memory which suggests that a reader can remember and analyse this many items at any one time.
This principle is just as relevant to technical product documentation as it is to business processes, and can apply to items in a list, steps in a procedure, or sentences in a paragraph. At a higher level, there should be 5±2 topics in a chapter and ideally only 5±2 chapters in a product guides.
The study in question which gave us these particular numbers is now considered a little outdated, however the principle itself remains a good one: human short-term memory is limited. Too many steps, options or paragraphs and your reader will struggle to remember where they started.
Both technical product information and business processes need to be accurately and consistently documented, so both can benefit from the Information Mapping Method.
The principles in particular can be used as high-level planning guidelines, and can apply to processes as well as conceptual and reference topics. They can also help documentation achieve regulatory compliance.
In some cases, though, we need to bend these rules a little: it is not such a disaster to include ten chapters in a guide where this is unavoidable. At 3di Information Solutions, we use these Information Mapping principles alongside our own style guides and content models to produce content that is consistent, useful and accessible.
George works as 3di’s Service Delivery Director. Passionate about helping each individual team member reach their full potential. Outside of work George can be found cycling, reading books on business and psychology, as well as taking the odd trip to Spain or Germany.