Decision log: writing down what was decided and why
A decision log records what was decided, by whom, and what was rejected. The format that takes two minutes, and why the rejected options are the part worth keeping.
Knowledge capture fails as a documentation project and works as a habit attached to real work. Where to start, what to skip, and why the expert is the wrong person to write it.
Knowledge capture usually begins when somebody resigns, which is the worst possible moment: the person has two weeks, no incentive, and the knowledge is now a negotiating position rather than a shared asset. Done as a habit it costs almost nothing. Done as a project it produces a folder of documents written in a hurry that nobody opens, and the organisation concludes documentation does not work.
People who know something well are the worst at explaining it, because they cannot see what they are assuming. The productive pattern is the opposite: the person who does not know writes it, the expert corrects it. That also produces a document pitched at the right level, and it tests comprehension in the only way that matters — somebody who did not previously know now does, and the gaps appear immediately rather than at the next handover.
Capture at the moment of doing, not afterwards. Somebody working through an unfamiliar process is the ideal author for the first five minutes of it, and that window closes as soon as they become competent.
Ask for the list of things they think only they know, then have somebody else attempt each one with them watching. That finds the real gaps in an afternoon, where interviews produce a reassuring document and no transferred capability. And write down what they are worried about on their way out — departing people are unusually honest, and they tend to name the risk everybody else has normalised.
Ettex Notes suits the habit form: one page per thing, dated and authored, searchable without a structure anybody has to maintain. Where the material becomes a procedure other people follow, it graduates into a standard operating procedure rather than staying a note.
The person learning it, corrected by the person who knows. Experts cannot see their own assumptions, which is exactly what a newcomer stumbles over.
Start with what only one person can do and what gets asked repeatedly. Attempting comprehensive coverage is the most reliable way to end up with nothing.
While somebody is doing the thing, especially the first time. A notice period is the worst time and unfortunately the most common one.
A decision log records what was decided, by whom, and what was rejected. The format that takes two minutes, and why the rejected options are the part worth keeping.
An annual general meeting has rules about notice, quorum and voting that decide whether its resolutions are valid. What to get right, and what small companies can skip.
Every note taking app markets its most elaborate feature — linked databases, AI summaries, infinite canvases. What decides whether you keep using one is duller: how fast it opens and whether you can find anything a year later.