1. EachPod
EachPod

When the pain of ignorance exceeds the pain of learning

Author
Tom Johnson
Published
Sun 23 Jul 2017
Episode Link
https://idratherbewriting.com/2017/07/23/pain-of-ignorance-versus-pain-of-learning/

Users turn to documentation when the pain of their ignorance exceeds the pain of learning. Unfortunately, this is the worst state of mind to try to learn anything in. To address this impatient state of mind, we need to write documentation in simpler, easier to digest ways. Task-based documentation gets us part way there. But the varying starting points, unique pathway needs, and messy branching complicate the promised simple linear nature of steps. Overall, we need to increase the simplicity factor in our docs much more than we generally do.

Share to: