Cognitive Ergonomics in Technical Writing - Lessons from the Field
summary
Explains concrete fixes: crypto wallets generate a 12–24‑word master seed that signup flows force users to write down by disabling copy paste and screenshots; MetaMask renames it secret recovery phrase to improve mental models; recommends a linked, repeated glossary and embedding definitions in user flows; cites static‑site tooling experience with Docuaurus and MkDocs and notes Sphinx supports in‑page glossary syntax; reports real loss example (Stefan Thomas 2000 million) to justify insisting docs integrate with UX and enforcement mechanisms.
AI-written summary · about
chapters (14)
- 0:00Intro
- 0:35About Anita
- 2:10Naming and Terminology
- 3:40Understanding
- 7:47Terminology
- 10:19Reusing Existing Terminology
- 13:10Fast and Slow Thinking
- 18:40User Experience UX
- 20:18Documentation Culture
- 30:59Architecture design
- 32:44Defining terminology
- 34:21Static site generators
- 36:33Unified terminology
- 38:14Use the same terminology
related talks
13mIterative Design of An Accessible Crypto Wallet for Blind Users
26mPractice Makes Perfect: Write Accessible Documentation
16mCognitive A11y: Designing Neuroaccessible docs for Neurodivergent minds
38mDesigning for people with cognitive impairments
39mUX & Cognitive Accessibility
49mUsability for Developers
45mBuilding Trust with UX Design: Examples from IoT and Beyond
01h 02mA developers guide to the UX galaxy