Brixo All articles
Productivity

Every Time Someone Asks 'How Do We Do This?' Your Team Is Paying for a System You Never Built

Brixo
Every Time Someone Asks 'How Do We Do This?' Your Team Is Paying for a System You Never Built

The Question That Keeps Coming Back

"Hey, how do we handle refund requests again?"

"Quick question — what's our process for escalating a bug to engineering?"

"Do you know where the brand guidelines are? I can never find them."

Every team has a version of these questions. They cycle through Slack channels and email threads like a slow drain — individually harmless, collectively brutal. Nobody tracks them. Nobody adds them up. But if you did, you'd find something uncomfortable: the same questions get asked repeatedly, the same people get interrupted to answer them, and the same knowledge gets reconstructed from scratch over and over again.

That's documentation debt. And unlike technical debt, it doesn't show up in any backlog.

What Documentation Debt Actually Looks Like

Documentation debt isn't just "we don't have a wiki." Plenty of companies have wikis. Most of them are either out of date, impossible to navigate, or both — which means people stop trusting them and go back to asking colleagues directly.

The debt accumulates in a few distinct ways:

Tribal knowledge concentration. Certain people become the unofficial experts on certain processes. They answer the same questions repeatedly, often through multiple channels, at unpredictable times. This is expensive for the person being asked — interruptions fragment focus — and fragile for the organization. When that person leaves, the knowledge walks out with them.

Inconsistent execution. When processes aren't documented clearly, different people handle the same situation differently. That inconsistency creates downstream problems: customer experience varies, handoffs break, QA catches things that shouldn't have gotten that far. The root cause is almost always the same — nobody agreed on the one way to do it and wrote it down.

Onboarding drag. New hires in knowledge-poor environments take longer to become effective because they spend their early weeks reconstructing institutional knowledge that should have been waiting for them. (This compounds the onboarding problem discussed elsewhere — poor documentation and poor onboarding are usually the same problem wearing different hats.)

Decision loops. Without documented context for why things are done a certain way, teams relitigate settled decisions. Meetings get called to answer questions that were answered eighteen months ago. People waste real time reaching a conclusion that already exists — they just can't find it.

Let's Put Numbers on This

Here's a rough model. Take a team of 20 people. Assume each person fields or initiates an average of three repeated-knowledge questions per day — a conservative number for most teams. Each one costs maybe 10 minutes when you factor in the interruption, the context switch, and the time to compose or find an answer.

That's 30 minutes per person per day. Across 20 people, that's 600 minutes — 10 hours — of compounding, daily, recoverable productivity loss. Per week, that's 50 hours. Per year, you're looking at roughly 2,500 hours of team time spent on questions that a well-maintained knowledge system would have answered in 30 seconds.

At an average fully-loaded cost of $75/hour across a mixed team, that's $187,500 annually. From questions.

Now consider that this number grows as the team grows, and shrinks only if you actively invest in reducing it. Documentation debt, unlike most debts, doesn't stay flat while you ignore it. It earns interest.

Why Existing Documentation Systems Fail

Before talking about what works, it's worth understanding why most documentation efforts collapse. The failure modes are remarkably consistent:

Built for the writer, not the reader. Most documentation is organized around how the author thinks about information — by department, by tool, by chronological process. Readers search by task or question. That mismatch means people can't find what exists, so they ask someone anyway.

Maintained by nobody. Documentation that lives in a wiki owned by everyone is effectively owned by no one. When processes change, nobody updates the docs because it's not anyone's explicit job. Within months, the docs are wrong, people know the docs are wrong, and they stop consulting them.

Created in a burst, never revisited. Many companies do a documentation sprint — often during a slow quarter or when a new tool gets adopted — and then treat the output as permanent. Living systems require living maintenance. A knowledge base that doesn't get updated is just a historical artifact.

Too formal to contribute to. If adding to the knowledge base requires a specific template, a review process, or navigating a complicated CMS, people won't do it. The friction of contribution has to be lower than the friction of answering a Slack message.

A Framework That Actually Works

The teams that have cracked self-serve knowledge systems tend to share a few structural commitments:

Answer once, link forever. Every time someone answers a repeated question verbally or in a message, they should immediately add it to the knowledge base and link to it. Not rewrite it — just capture it. Over time, this builds a library of real questions with real answers, organized by how people actually ask.

Assign ownership explicitly. Every section of the knowledge base should have a named owner who is responsible for keeping it current. That owner changes when roles change. It doesn't have to be a big time commitment — quarterly reviews are often enough — but the accountability has to exist.

Build for search, not navigation. Most people don't browse knowledge bases. They search them. That means good titling matters enormously. Name docs by the question they answer, not by the concept they describe. "How to process a customer refund" will get found. "Refund Policy and Procedures" won't.

Create a "question graveyard." Some teams maintain a running log of every question asked in Slack or email that wasn't answered by existing documentation. This log becomes the prioritization queue for documentation work. If the same question appears three times, it earns a doc. This turns reactive answering into proactive knowledge building.

Make contribution the path of least resistance. If your knowledge system is a Notion page or a Confluence space, create a single "inbox" page where anyone can drop a rough note, a link, or a voice memo. A designated person (rotating, low time commitment) cleans and organizes the inbox weekly. Raw contribution is easy; curation is centralized.

The Compounding Goes Both Ways

Here's the flip side of documentation debt: documentation investment also compounds. A knowledge base that's genuinely useful gets consulted more. The more it gets consulted, the more people trust it. The more people trust it, the more they contribute to it. Within six to twelve months of a committed documentation effort, teams report that the "how do we do this?" questions drop dramatically — not because people stopped asking, but because the system started answering before the question could form.

That's the Brixo model in practice: build the system once, let it work for you indefinitely. The upfront investment in documentation infrastructure pays dividends in every sprint, every onboarding cycle, and every quarter you don't spend relitigating decisions that were already made.

All Articles

Related Articles

The Invisible Skill Drain Slowing Your Shipping Velocity

The Invisible Skill Drain Slowing Your Shipping Velocity

Why Giving Your Best People More Software Is Driving Them Out the Door

More Tools, Less Output: The Sprawl Problem Quietly Strangling Your Best Teams

More Tools, Less Output: The Sprawl Problem Quietly Strangling Your Best Teams