Description
Replace bulky documentation with short task cards or a minimal manual that get users doing real work quickly and help them check success and recover from errors.
Minimalism reacts against the profusion of documentation: give users only what they need to start common real tasks, because people do not read large manuals but do benefit from minimal ones. A guided exploration card has a short task heading, a few concrete steps, a check that confirms success and a recovery section for the commonest error (for example forgetting the equals sign when entering a spreadsheet formula). Nielsen frames it within wider documentation advice: procedures in task order, ways for users to check success, three levels of documentation (reference cards, tutorials and reference manuals), and self-contained volumes. The rigour comes from building the cards around observed real tasks and errors and testing them with new users.
Attributes
- Discipline
- Design & Product Practice
- Loss type
- Siloed
- Stage
- Design
- Data
- Qualitative
- Effort
- Days
Steps
- Identify the common real tasks new users must be able to start with, ideally from observation or support data.
- Write one short card or section per task with a clear heading and a few concrete steps in task order.
- Add a check that lets users confirm they succeeded.
- Add a recovery section for the commonest error on that task.
- Keep detail out; point experts to reference material instead.
- Test the cards with new users and revise where they stall or err.
Sources
- Usability Engineering (Nielsen, 1993)
Also known as
- Minimalist documentation
- Minimal manual
- Guided exploration cards
Categories
- Design
- Design & Product Practice