Every team has the doc. The onboarding guide that still names a tool you replaced last year. The policy page with a number nobody trusts. The runbook that works right up until the step that no longer exists.
Nobody wrote those pages badly. They were accurate the day they were published. The problem is what happened next: the work kept moving, and the doc stood still.
Staleness is a process problem, not a writing problem
The usual fix is a documentation push. Someone senior declares a docs week, everyone grumbles, the wiki looks great for a month, and then the decay starts again. That cycle repeats because it treats the symptom.
The cause is structural:
- The truth changes in other tools. The real decision lands in a ticket, a thread, or a release note. The doc is the last place to hear about it.
- Updating is nobody's job. The person who changed the system is not the person who owns the page, and neither of them is thinking about the other.
- Readers do not report drift. When someone finds a stale page, they ask a colleague instead and move on. The page stays wrong for the next reader.
A knowledge base is not a library. It is a ledger, and a ledger is only useful while someone is keeping it.
What keeping it honest actually takes
Teams that hold the line on documentation do three things consistently.
They tie pages to sources. Every page has an upstream: the system, policy, or decision it describes. When the upstream moves, the page is flagged, not discovered.
They review on a cadence, not on a crisis. A monthly pass over the pages that matter beats a yearly rewrite of everything. Small, boring, regular.
They make the fix cheaper than the workaround. If proposing an edit takes thirty seconds, people do it. If it takes a form and a committee, they ask a colleague instead.
Where Husn fits
This is the exact loop Husn runs for you. It watches the tools where the truth actually changes, drafts the doc update when something moves, and routes it to a human for approval. The page gets a verified stamp when it is checked and an outdated flag when its upstream moves.
You stay the editor. Husn just makes sure the ledger never quietly falls behind the business it describes.