Anti-pattern
The read-only wiki nobody updates
- Taxonomy
anti_patterns.governance- Severity
- catastrophic
- Symptom
- New hires are told "everything is in the wiki", then 30 minutes later told "actually, ask in Slack". Pages have a 2023 timestamp and reference a service that was deprecated last summer. Edit history shows one author, two years ago.
- Root cause
- Knowledge work was capture-only. No incentive, ritual, or process owner makes editing the wiki part of finishing a task. The cost of writing is paid by the author; the cost of staleness is paid by future readers — a classic externality.
- Fix
- Make wiki updates a step in the workflow that produced the change. Named owner per page. Visible decay timestamps. Mass-archive unowned pages. Smaller wiki, higher trust.
- First documented
- 2010
How it presents
- Onboarding doc is technically there, but new hires learn from pairing instead.
- Search returns three pages with conflicting answers; the most recent one is from someone who has since left.
- The Slack channel for “ask anything” sees 10x the traffic the wiki does.
- A motivated junior writes an excellent updated guide. It is greeted with thanks and immediately becomes the next stale page.
Why it always wins
Three forces push every team wiki toward this failure mode:
- Capture is free, maintenance is expensive. Writing a page is one person’s afternoon. Keeping 200 pages truthful is permanent overhead nobody is staffed for.
- Tools optimise for capture. Notion, Confluence, and the rest make it trivial to start a new page and almost invisible to mark one as decayed.
- Removing content feels like deletion of effort. So nobody deletes; the index grows; signal-to-noise falls; trust erodes.
How real teams fix it
- Wikis-as-output-of-work, not wikis-as-input. A PR is not done until the page that references the changed thing is updated. An incident review writes its own postmortem page. Otherwise the wiki is a side quest nobody completes.
- Owners, not authors. Every load-bearing page has a named owner (a person or a rotating role). Unowned pages are mass-archived once a quarter, no debate.
- Visible decay. Show “last reviewed N days ago” on every page. Pages older than a threshold render with a banner.
- Smaller is better. The truthful 30-page wiki beats the comprehensive 600-page one. Aggressively delete; trust compounds.
Why we’re calling it out here
Almost every PKM tool in the tools section — Notion, Obsidian, Logseq, Capacities, Anytype, Roam Research — is capable of producing world-class knowledge bases and capable of becoming a graveyard. The tool choice matters far less than the governance. Choose the governance first.
Sources
- Brandon Hsiao — The wiki is not the source of truth.
- Will Larson — Engineering strategy: writing it down.