documentationteamsknowledge
The team that only exists in someone's head
The most valuable thing a small team owns is what everybody knows, and it walks out of the door the day someone does.
The most valuable thing a small team owns is not in any of its accounts, and it is the one thing nobody is responsible for maintaining. It is what everybody knows. Not what is written down, what is known: why that client must never be rung before eleven, which supplier will quietly fix a mistake if you ask nicely and which will charge you for breathing, the reason the thing was built the odd way it was built, the fact that the odd way is load bearing and the tidy looking alternative broke everything the last time somebody tried it. On a small crew all of this lives in people's heads, and it lives there very efficiently, right up until the head goes on holiday, or takes a better offer, or is simply off sick on the one day the thing goes wrong, and then you discover, all at once and expensively, how much of your business was being run out of a single memory that has left the building.
I used to think writing things down was bureaucracy, the sort of thing big slow places do instead of working, and on a small team every hour spent documenting is an hour not spent shipping, so it always loses the argument in the moment. It loses the argument every single time, which is exactly why teams stay undocumented, because the cost of not writing it down never arrives on the day you did not write it down. It arrives months later wearing a different face, disguised as a crisis, and by then nobody connects the panic to the note that was never made. That is the whole trap. The saving is immediate and visible and the bill is delayed and unattributed, and human beings are famously poor at pricing that particular shape of bargain.
So I have made my peace with a small, dull discipline. When somebody solves a problem that took real thinking, I ask them to spend ten minutes writing down not the answer but the reasoning, the why, because the answer will be out of date by spring and the reasoning almost never is. When a decision is made in a meeting, one line goes somewhere findable: what we chose, and the thing we were worried about when we chose it, because the second half is what saves the next person from cheerfully reopening a door you closed for a good reason. None of this is a system, and I distrust anyone selling you a system for it. It is just the habit of leaving a trail, so that the person who comes after you, who is quite often a tired version of you in eighteen months, is not forced to rediscover from scratch what the team already paid to learn once. A business that only exists in the founders' heads is not a business yet. It is a very impressive performance that ends the moment the performers do, and the whole point of building something, as opposed to merely doing something, is that it should be able to survive you having a day off.
More from the journal
More by Morgan Ellery
- The meeting is the note you never wrote 6 Sep 2026
- The yes you give in the corridor 4 Sep 2026
- A short list from a small crew 31 Aug 2026
Discussion
House rules
- Sign how you like, but be one person. You may use the name on your account, a name of your own choosing, or none at all. What you may not do is wear somebody else's: no pen name of ours, no member's name but your own, and nothing that reads as the studio or its staff.
- Argue with the point, not the person. Robust disagreement is welcome; contempt is not.
- Nothing unlawful, hateful or harassing, nothing that identifies a private individual, and no advertising.
- Post only what is yours to post. That includes other people's writing and private correspondence.
- We may hide a remark, remove it, or close an account to the discussions, and we may do so without notice.
What a chosen name is and is not
A chosen name hides you from the room, not from us. Every remark stays linked to the account that wrote it, and the studio can see that link whenever it needs to. Please treat it as a way to speak freely, not as a way to say something you would not put your name to.
Where responsibility sits
Remarks in this thread are written by members and published without prior review. They are the views of the people who wrote them and not those of eQuill Studio. We do not verify their accuracy, and we accept no liability for them or for any decision taken in reliance on them.
If something here breaks these rules or infringes your rights, report it and we will look at it promptly.
House rules
- Sign how you like, but be one person. You may use the name on your account, a name of your own choosing, or none at all. What you may not do is wear somebody else's: no pen name of ours, no member's name but your own, and nothing that reads as the studio or its staff.
- Argue with the point, not the person. Robust disagreement is welcome; contempt is not.
- Nothing unlawful, hateful or harassing, nothing that identifies a private individual, and no advertising.
- Post only what is yours to post. That includes other people's writing and private correspondence.
- We may hide a remark, remove it, or close an account to the discussions, and we may do so without notice.
What a chosen name is and is not
A chosen name hides you from the room, not from us. Every remark stays linked to the account that wrote it, and the studio can see that link whenever it needs to. Please treat it as a way to speak freely, not as a way to say something you would not put your name to.
Where responsibility sits
Remarks in this thread are written by members and published without prior review. They are the views of the people who wrote them and not those of eQuill Studio. We do not verify their accuracy, and we accept no liability for them or for any decision taken in reliance on them.
If something here breaks these rules or infringes your rights, report it and we will look at it promptly.
This thread belongs to this piece alone. Members choose how they are signed, and can change it from the box below. When the studio or the writer joins in, the page says so with a badge, so you always know who is talking.
OPENING THE THREAD…