There’s more to creating effective documentation than merely gathering information. As a consumer of documentation, you know this to be true. Because you’ve been there. We all have.
At first enthused by the seeming treasure trove of information assembled to guide your learning and project progress, your excitement is quickly dashed as your search for the proverbial needle in a haystack drags on. What first appeared as the holy grail of actionable knowledge becomes a fruitless quest for that one elusive piece of information you need to move forward on a task. Sheepishly, you turn to a more experienced colleague and ask for a lifeline.