How to Run a Documentation Audit
How to run a documentation audit — a practical guide for teams who want to systematically assess what documentation exists, what's accurate, what's
Team Knowledge
How to preserve institutional knowledge — a practical guide for organizations who want to capture the accumulated understanding that makes experienced
Institutional knowledge is the accumulated understanding that makes an organization able to function — the context behind decisions, the history of what was tried and why it failed, the informal networks that get things done, the interpretation of policies that makes them workable, the lessons from past incidents that prevent future ones.
It is not the same as documented procedures or official policies, though it may overlap with them. Institutional knowledge is what experienced employees know that lets them navigate situations that the official documentation doesn't cover — or that contradicts it.
Examples:
This knowledge is invisible to new employees and to anyone who wasn't there when it was acquired. It shapes organizational decision-making constantly but appears in no formal documentation. And it lives entirely in the heads of the people who were present for the experiences that produced it.
When those people leave, the knowledge leaves. The organization relearns the lessons, makes the same mistakes, or carries the consequences of decisions whose reasoning is now unknown.
Understanding what kind of knowledge is at risk helps prioritize what to preserve.
Decision context: Why specific decisions were made, especially decisions that look arbitrary or suboptimal without the original reasoning. Why is the CRM organized this way? Why don't we integrate with this vendor? Why is this process as complex as it is? The answer is often "because of a specific incident, constraint, or failure" — but that reasoning lives only in the memory of the people who were present for the decision.
Decision context is the most historically important institutional knowledge because without it, future decision-makers either blindly repeat past mistakes or avoid things that aren't actually wrong. The memo saying "we tried this in 2019 and here's what happened" is more valuable than it looks.
Operational knowledge: How to actually do things — the unofficial procedures that make official procedures work, the workarounds for system limitations, the undocumented edge cases in standard processes. This knowledge often lives with the people who execute processes daily and have adapted to their actual behavior rather than their documented behavior.
Network knowledge: Who to call. Who knows what. Who can make a thing happen that the official channel can't. What the real decision-making authority is versus the official org chart. Which cross-functional relationships enable work that the formal process would block. Network knowledge is the most intangible form of institutional knowledge and the hardest to document — but it's often what separates effective operators from ineffective ones.
The most obvious trigger for institutional knowledge preservation is an employee leaving. A structured off-boarding knowledge transfer is the minimum viable response to knowledge loss.
Most off-boarding focuses on operational tasks: returning equipment, revoking access, handing off in-progress work. Knowledge transfer is often an afterthought — a brief conversation about "are there any important things we should know?" that happens in the last week.
A structured knowledge transfer is different. It happens over several weeks, with specific questions designed to surface tacit knowledge.
The knowledge transfer interview: Conduct a structured interview with the departing employee 4-6 weeks before their last day. Questions that surface different types of institutional knowledge:
Decision context questions:
Operational knowledge questions:
Network knowledge questions:
The interview output becomes documentation: specific, concrete entries in the team knowledge base.
The shadow sessions: For operational knowledge that's best demonstrated rather than described, schedule shadow sessions where the departing employee walks through their most critical processes with a replacement or colleague observing. The observer asks "why did you do that?" at every non-obvious step. This surfaces tacit knowledge that the employee doesn't know to mention because it's automatic.
Knowledge preservation that starts at off-boarding is reactive — the knowledge is already at risk of leaving. Proactive institutional knowledge preservation is a succession planning practice: identify critical knowledge now, before the people who hold it are leaving, and build redundancy.
The knowledge audit: For each critical function or system, identify: who has the essential knowledge to operate it? Who is the backup? If the primary person left this month, how quickly could the organization recover?
Knowledge concentrations that have no backup are the highest-risk institutional knowledge silos. Addressing them before a departure is less disruptive than addressing them after.
The "brain trust" documentation: For domain experts — the people whose knowledge is so deep and accumulated that it can't be transferred in an off-boarding interview — a structured knowledge externalization project. The expert spends 10-15% of their time over 6-12 months with an assigned interviewer and documentation partner, systematically externalizing their knowledge into documents, runbooks, and decision frameworks. The output is not a substitute for the expert's judgment, but it's a guide that significantly reduces the expertise cliff when they leave.
Deliberate cross-training: Assign team members to work closely with domain experts before knowledge transfer becomes urgent. An engineer who has worked directly with the systems architect on three projects has absorbed significant institutional knowledge about the architecture, the decisions behind it, and the constraints that shaped it. This is the most effective long-term institutional knowledge preservation — knowledge absorbed through work is retained more durably than knowledge transferred in documentation.
One of the most valuable and most neglected forms of institutional knowledge preservation: documenting why significant decisions were made, at the time they were made.
A "history of this decision" document doesn't need to be long or formal. For any decision that will shape the organization for years — a strategic choice, an architectural decision, a significant policy — a brief document that records:
This documentation is written at decision time, when the context is fully loaded. It's almost free to produce then. The same document, produced three years later when someone asks "why do we do it this way?", is impossible to produce accurately because the people who remember the context have moved on.
Large-scale version: the ADR (Architecture Decision Record) in engineering contexts; the policy rationale appendix in operations contexts; the strategic decision log in leadership contexts. All serve the same function: making the reasoning behind decisions visible to future stakeholders who weren't present.
Network knowledge — the informal relationships and authority structures that make work possible — is the hardest to document because it's inherently relational and contextual.
The most effective preservation approach is direct introduction rather than documented description. When an experienced employee who holds network knowledge is transitioning out of a role, structured introductions to their key contacts are more valuable than a contact list.
"This is Marcus. He's been my primary contact at the payment processor for four years. He knows our account history, he can escalate issues internally, and he calls me directly when there's something unusual in our transactions. Let me introduce you and hand over the relationship."
This is more valuable than "contact Marcus at payments-partner.com for transaction issues" — because it conveys the relationship context that makes the contact useful.
Network knowledge can also be partially documented in the "who to contact for what" format — not just names but the relationship context: "We have a direct escalation contact at [vendor] because we were their first enterprise customer. If you run into a billing issue, contact [name] directly rather than going through standard support. Our account history is in Salesforce."
One specific form of institutional knowledge that's particularly valuable and particularly likely to be lost: lessons from past failures.
Organizations make the same mistakes repeatedly when they don't have a system for capturing and distributing the lessons from errors. The team that ran a marketing campaign that violated platform policy and got their account suspended captures a lesson; if that lesson is never written down, the next team doesn't know.
The lesson register: A structured collection of significant lessons — mistakes made, problems encountered, things that failed unexpectedly — with enough context to prevent repetition.
Lesson register entry format:
LESSON REGISTER ENTRY
Date: 2024-11-03
Category: Vendor Management
Lesson: Contract auto-renewal without review led to 12-month lock-in at 40% price increase
What happened: [2-3 sentences on the specific incident]
Root cause: No process for reviewing vendor contracts 60 days before renewal date
Prevention: Add vendor contract renewal calendar with 60-day review trigger
Owner of prevention action: @ops-lead
Status: Prevention implemented (2024-12-01)
The lesson register is not a complaint box or a blame document — it's a proactive memory system. The framing is: "here's what we learned, here's how to prevent it from happening again."
The observable symptom of failed institutional knowledge preservation is the reinvention problem: the organization repeatedly rediscovers the same insights, makes the same mistakes, and debates the same decisions that were already made and resolved.
Symptoms:
The reinvention problem is not a productivity problem — it's a knowledge problem. The organization is doing work it has already done, because the result of the prior work was never preserved.
The solution is not more documentation generally — it's systematic documentation of decisions and lessons at the time they occur. A decision log entry takes 10 minutes to write. An incident lesson takes 20 minutes to document. Neither requires a separate project or a dedicated resource. What they require is a norm: "when we make a significant decision or learn a significant lesson, we write it down."
Setup: A 60-person B2B software company. The two engineers who built the core architecture of their main product are both planning to leave within 6 months. The product has been running for 7 years. Documentation: sparse. The architecture has accumulated many non-obvious design decisions that are not documented anywhere.
What they do:
Month 1: Knowledge audit. The engineering manager maps every architectural decision they can identify and who holds the reasoning. 23 architectural decisions have documentation; 44 do not. The two departing engineers are the only people who can explain the undocumented ones.
Months 2-4: Structured interviews. A technical writer interviews each engineer weekly, using the decision context questions above. Each interview produces 2-3 documented decisions. Over 12 sessions, they document 32 of the 44 undocumented decisions. The remaining 12 are documented by the engineers directly with the interviewer's prompting.
Month 3-5: Shadow sessions. Junior engineers shadow each departing engineer through 6 critical operational scenarios. The shadow sessions surface 18 additional operational knowledge items that didn't emerge in the interviews.
Month 6: The two engineers leave. The documentation is incomplete — it always is — but the remaining team can operate, diagnose, and extend the architecture. Two subsequent incidents are resolved using the documented reasoning. Three architectural decisions in the following year reference the documented history.
Institutional knowledge is the most valuable and most fragile organizational asset: it accumulates slowly through years of experience, shapes every decision and process that the organization executes, and can disappear rapidly when the people who hold it leave. The practices that preserve it — structured off-boarding interviews, at-time-of-decision documentation, deliberate cross-training, lesson registers, and proactive succession planning — are not expensive individually. What's expensive is their absence: organizations that don't preserve institutional knowledge pay in repeated mistakes, reinvented work, and the steady erosion of organizational memory. Teams that build preservation practices into their normal operations build organizations that learn, that remember, and that improve — rather than ones that regularly rediscover the same lessons their predecessors already learned.
See also: Web Clipping vs. Bookmarking.
More WebSnips articles that pair well with this topic.
How to run a documentation audit — a practical guide for teams who want to systematically assess what documentation exists, what's accurate, what's
How to break down knowledge silos — a practical guide for teams and organizations where critical knowledge is trapped in specific people, teams, or
How to build a company handbook — a practical guide for founders, operations leaders, and HR teams who want a handbook that communicates what the company
How to build a company knowledge base — a practical guide for teams and organizations who want to capture institutional knowledge, reduce repeated
How to build a decision log — a practical guide for teams and organizations who want a permanent, searchable record of significant decisions that makes
How to capture knowledge from departing employees — a practical guide for managers and HR teams who want to systematically extract institutional knowledge