AS
Aaron SuarezValencia City, PH · remote-first
Universal searchFind your way through the site

The wiki exists. The SOPs exist. Someone spent a whole weekend on the folder structure, and it’s genuinely tidy. And the team still asks the senior person — because asking takes ten seconds and finding takes ten minutes, when it works at all.

This is the part most documentation projects get wrong: they optimize for completeness when the only metric that matters is retrievability at the moment of work. Documentation has exactly one test. When someone is mid-task and stuck, can they reach the right answer faster than interrupting a human? Pass that test and the docs are infrastructure. Fail it and they’re organized noise — accurate, comprehensive, alphabetized, and functionally identical to not existing.

Three failure modes account for most of the noise. Wrong place: the answer lives in a knowledge base nobody is inside of when the question occurs; the fix is moving answers into the work surface itself — the CRM field description, the workflow step, the template header. Wrong moment: the doc explains everything about the system instead of the one decision the reader is facing; the fix is writing for situations, not subjects. Wrong trust: the doc was right once, then the process changed and the doc didn’t, and one stale answer poisons the well — after that, people verify everything with a human anyway, which means the documentation now costs time instead of saving it. The fix is ownership and review dates, same as any other production system.

Write less. Position better. Assign owners. A five-line answer that lives where the question happens beats a forty-page manual that lives where documents go to be archived.

The organizational version of this — what happens to companies whose knowledge can be stored but never retrieved — is Case 11 in Organizational Physics: archives are not memory.

↑ top