The smell of scorched rosemary and garlic is currently fighting with the ozone scent of a dying laptop fan, and honestly, the rosemary is losing. I was trying to multitask-basting a chicken while explaining to a frantic junior engineer why our ‘Source of Truth’ just told him to delete a production database shard. He was looking at a Confluence page from 2021. The instructions were written for a version of our infrastructure that was sunset exactly 31 months ago. I burned dinner because I was too busy firefighting a ghost. This is the reality of the modern internal knowledge base: it isn’t a library. It’s an attic filled with old newspapers, broken furniture, and unexploded ordnance that we’ve convinced ourselves is an asset.
Leo, the new hire in this particular horror story, was just trying to do his job. He had 11 browser tabs open, each one a different ‘official’ guide to our onboarding process. […] By the time I smelled the smoke from my kitchen, the customer had already hung up, and Leo was staring at his screen with the hollowed-out expression of someone who just realized the map they were given was drawn for a completely different continent.
The Danger of Speeding Towards the Wrong Exit
Jamie W., a researcher who spends his life watching how crowds move through airports and burning buildings, once told me that the most dangerous thing in a crisis isn’t the lack of information-it’s the abundance of the wrong kind. He pointed out that when a crowd is given a map that doesn’t match the exits, they don’t just stop. They accelerate. They run faster toward the wrong doors because the ‘official’ nature of the map gives them a false sense of security.
Yields Zero Results
Actual Value
In a corporate setting, this translates to a 41% increase in ‘busy work’ that yields zero results. We are sprinting toward exits that were bricked up during the 2021 reorganization.
[the map is not the territory, especially when the map is a three-year-old pdf]
Knowledge Cemetery vs. Living Organism
We treat documentation as a one-time tax we pay at the end of a project. We ‘write it down’ so we can forget about it. But information isn’t a static object; it’s a living organism that requires a constant caloric intake of updates and pruning. Most companies have a ‘Knowledge Base’ that is actually a ‘Knowledge Cemetery.’ We bury ideas there and hope they stay put. But they don’t. They haunt the new hires. They whisper half-truths to the support staff. They provide just enough confidence to let a developer make a catastrophic mistake.
I remember reading a study-though I can’t recall if it was in a journal or another cursed wiki-that suggested for every 101 pages of documentation a company creates, only 11 are actually accessed more than once a year. The other 91 pages sit there, gathering digital dust and slowly turning into misinformation.
It’s a hoarding problem. We are terrified of hitting ‘delete’ because ‘we might need that context someday.’ But context without currency is just baggage. If I tell you how to start a fire by rubbing two sticks together, that’s great context for the Stone Age, but it’s actively harmful if you’re currently standing in a room full of gasoline and asking for a lighter.
Institutional Neglect: The Lust for Launch
Jamie W. calls this ‘Institutional Neglect.’ It happens when the leadership values the act of creation over the act of curation. It’s much sexier to launch a new product than it is to go back and delete the 51 outdated help articles that the new product just rendered obsolete. We incentivize the ‘new’ and ignore the ‘old,’ forgetting that our employees spend 21% of their day just trying to verify if the information they found is actually true. That is 21% of your payroll spent on a scavenger hunt where the prize is a headache.
The AI Librarian: A Single Source of Truth
Aissist approaches this from a different angle, recognizing that the human brain isn’t built to manually curate 1001 pages of changing technical specs. By using AI that can be trained on specific, curated, and high-quality data, it starts to act like a single source of truth that actually filters out the noise.
Contextual Filtering
It doesn’t just show you the 2021 guide because it contains the keyword ‘database’; it understands the context of the 2024 architecture. It turns the ‘attic’ back into a functional workspace by highlighting where the rot has set in. It’s the difference between a library where books are randomly tossed into a pile and one where an intelligent librarian is constantly checking the pulse of the collection.
I’m not saying we should hand over all our thinking to the machines. That’s a different kind of trap. But we have to acknowledge our own limitations. We are currently drowning in the ‘legacy’ versions of ourselves. Every time a process changes, we leave the old version behind like a snake shedding its skin, but in our digital world, that old skin stays right there, looking remarkably like the snake. A new employee can’t tell the difference between the living process and the dead one until they try to pick it up and get bitten.
[documentation is a debt that we refuse to pay down]
We are subsidizing our own confusion.
The Cost of Disrespect
There is a specific kind of psychological safety that comes from a clean workspace. Jamie W.’s research shows that when people are in an environment with clear, accurate signage, their heart rates are 11% lower. They collaborate better. They take more calculated risks because they know where the floor is. When you give someone a messy wiki, you are telling them, ‘We don’t care enough about your time to make sure you have the right tools.’ It is a subtle, pervasive form of disrespect. It says that the company’s history is more important than the employee’s present.
The Dry Chicken Metaphor
All Ingredients Present
Good instructions existed.
System Failure
Distraction leads to error.
The Dry Result
Failure to execute well.
I eventually got my dinner cleaned up. The chicken was dry, the garlic was bitter, and the kitchen still smells like a campfire. It was a perfect metaphor for the day. I had all the ingredients for a great meal, and I had all the instructions, but I was distracted by the failures of a system that was supposed to make my life easier. We have to stop treating our knowledge bases like archives. An archive is for historians. A team needs a toolkit. If the hammer is made of glass and the screwdriver is from 1951, throw them out. Your team will thank you for the empty space, because at least in an empty space, they aren’t being lied to.
Delete by Default: Pruning for Sanity
We need to adopt a ‘delete by default’ mentality. If a document hasn’t been touched in 301 days, it should be flagged for execution. If no one can vouch for its accuracy, it should be burned. The fear of losing knowledge is what keeps us paralyzed, but we are losing much more through the presence of bad knowledge than we ever would through the absence of it. Silence is better than a lie. A blank page is better than a 2021 UI guide that leads a junior engineer into a production-level catastrophe.
In the end, our internal documentation is the only thing that scales. You can’t be in every Zoom call. You can’t answer every Slack message. You have to leave breadcrumbs. But for the love of everything holy, make sure they aren’t leading your team off a cliff.
We owe it to the Leos of the world to give them a map that actually matches the ground they are standing on today, not the ground we stood on 1001 days ago.