Context cardTransitional topic
Mental models and concept information: why readers need to know how it works before they act
How does research on mental models support placing concept information before task information in technical documentation?
The short answer
Research on mental models, from Philip Johnson-Laird (1983) and Donald Norman (1983, 1988), describes how people build internal representations of a system and use them to predict its behaviour and choose actions. Users form these models from the system image, which includes the documentation, so a short, accurate explanation of how the product works helps readers carry out tasks, infer what to do in unforeseen cases and interpret what they see. Concept information placed before or linked from the tasks is the documentation practice built on that finding.
For: Technical writers, information architects and UX writers who structure concept and task information
Key points
- A mental model is a reader's internal representation of how a system works; it is used to predict behaviour, plan actions and explain what happens.
- Norman distinguishes the designer's model, the user's model and the system image; users build their model only from the system image, which includes the documentation.
- Kieras and Bovair (1984) found that learners given a model of how a device works learned its procedures faster and inferred procedures they had not been taught.
- Concept information states the parts, states, operating modes and causal links a reader needs; tasks link to it rather than repeat it.
- A good model does not replace safety information: hazards, warnings and the limits of use are stated where they apply, whatever the reader's model.
The context
What the research shows
The term mental model in its cognitive sense goes back to Kenneth Craik (1943), who proposed that the mind builds small-scale models of reality to anticipate events. Philip N. Johnson-Laird (1983) developed it into a theory of comprehension and reasoning: people understand a description by building a model of the situation it describes and draw conclusions by inspecting that model.
Donald A. Norman (1983) studied mental models of devices and observed that they are incomplete, unstable, unscientific and partly superstitious, yet people rely on them. In The Design of Everyday Things (first published in 1988 as The Psychology of Everyday Things, revised 2013) he distinguished three models: the designer's conceptual model, the user's mental model and the system image, everything the product presents of itself, from controls and displays to labels and manuals. Users build their model only from the system image. Where it is unclear, they face what Norman calls the gulfs of execution (how do I make it do what I want?) and evaluation (did it do it?). The theory glossary describes the system image and the gulfs as terms of their own.
David E. Kieras and Susan Bovair (1984) gave learners either a description of how a control panel device worked or only the procedures. Those with the device model learned the procedures faster, retained them better and could infer procedures they had not been taught.
What it means for documentation
Documentation is part of the system image, so it shapes the model the reader builds. Several practices follow:
- Concept before task. A short explanation of how the product works, its parts, states and operating modes, placed before or linked from the tasks, lets readers understand why each step is needed. Information typing captures this as the DITA concept next to the DITA task.
- Models that predict. The concept states causal links ("pressure builds while the valve is closed"), not only names. That is what lets the reader handle a case the procedure does not cover.
- Consistency with the interface. Terms, states and messages in the text match the human-machine interface, so the reader's model and the system image agree.
- Correcting likely misconceptions. Where users predictably hold a wrong model, for example that a stopped machine is de-energized, the concept says so explicitly.
Not every reader needs the concept first: experts often skip it, and minimalist instruction warns against long explanations before action. A concept that is short, linked and optional serves both.
Limits
The evidence comes mostly from studies of device and software learning; how much concept a given audience needs is settled by task analysis and testing. A correct mental model does not make a reader safe. Hazards, warnings and the limits of intended use are stated where they apply in the instructions for use, whatever the reader's model, and their content follows from the risk assessment and the applicable law. No cognitive argument replaces the risk assessment or legally required safety information, and concept information never makes a product compliant.
Questions readers ask next
- Is this the same as the mental model in decision-making books?
- No. Here a mental model is a person's internal representation of how a particular system works, as studied in cognitive science and usability. The thinking-tool sense, a general concept used to reason about many situations, is a different glossary entry: Mental model (thinking tool).
- Should every task start with a concept?
- No. A task should link to the concept it depends on, and a short context sentence can open the task. Long explanations inside steps slow experts down; the concept is best a separate, findable topic.
- Can documentation fix a confusing interface?
- Only partly. Documentation can explain a model the interface does not show, but where the system image misleads users, the better fix is in the design. Documentation is part of the system image, not a substitute for it.
Sources
- Philip N. Johnson-Laird (1983), Mental Models: Towards a Cognitive Science of Language, Inference, and Consciousness — Harvard University Press, 5 October 2026
- Donald A. Norman (1983), Some observations on mental models, in Dedre Gentner and Albert L. Stevens (eds.), Mental Models — Lawrence Erlbaum Associates, 5 October 2026
- Donald A. Norman, The Design of Everyday Things, revised and expanded edition (2013) — Basic Books, 5 October 2026
- David E. Kieras and Susan Bovair (1984), The role of a mental model in learning to operate a device — Cognitive Science, 5 October 2026
Review log and changes
Every context card is checked against its sources before it is published, and again whenever it changes; the date under the byline is the last review. Corrections (something was wrong) and additions (something was missing) are logged below with date and time (Berlin time). Typos, formatting and link fixes are not listed.
Reviewed
No corrections or additions since publication.