All guides
Explainer8 min read

Why manual SOP maintenance fails as your company scales

Past about 50 people, a hand-kept wiki can't keep up with how fast work changes. Why it breaks, and how a self-updating knowledge base works instead.

Sami SIngesto

The short answer

Manual SOP maintenance fails at scale because the work of updating a document is optional, unpaid and happens last, while the number of people changing how work gets done grows with every hire. Past about 50 people, changes are made in Slack threads, meetings and email faster than anyone can copy them into Notion or Confluence, and a wrong page looks exactly like a right one. The alternative is a self-updating knowledge base: it reads the channels where work actually changes, updates the answer from them, and asks people only to settle conflicts, not to transcribe. Ingesto works this way: it connects to Slack, Teams, email, Drive and Notion, keeps the knowledge base in sync as those sources change, and flags conflicts to the topic owner.

What changes at 50 people

At 15 people, the wiki works because it barely has to. Everyone sits in the same channels and hears about every change. When the onboarding doc is wrong, the new hire asks the founder, who fixes it. The documentation is a backup for a company that mostly runs on shared memory.

By 50, that's gone. There are team leads who make decisions without the founders, channels half the company has never joined, and new hires every month who've never met the person who wrote the SOP they're following. The documentation stops being a backup and becomes the only way most people find out how things work. That's the point where manual upkeep starts to fail, because the job it's being asked to do has grown and the way it gets done hasn't.

The arithmetic is unforgiving. A 10-person team has 45 possible pairs of people who can agree on a change between themselves. At 50 people it's 1,225. At 150 it's 11,175. Every one of those pairs can make a decision in a DM or a thread that changes how something is done, and the wiki only hears about it if one of them remembers to write it down.

Six reasons manual upkeep breaks

None of these are about people being careless. They're about how static documentation is built.

1. Updating the doc is the last step, and it's optional

When sales ops changes the discount approval rule, the change is done once the CRM is updated and the team is told. Editing the SOP is extra work, done after the real work, for readers the editor will never meet. Under any deadline, it's the step that gets dropped.

2. A wrong page looks exactly like a right one

A stale SOP has the same formatting, the same confident tone and the same place in the sidebar as a current one. Nothing on the page tells a reader it was overtaken by a Slack message in June. People find out a page is wrong by following it and getting it wrong.

3. Reviews run on the calendar, and changes don't

Most review processes are "check every page every six months." But a procedure doesn't go wrong on a schedule; it goes wrong the day something changes. A calendar review finds a mistake on average months after it started, and most of the review time goes on pages that were fine.

4. Ownership decays

The person who wrote the returns SOP moved to a different team, then left. The page still lists them as the owner, or lists no one. Every reorg leaves a trail of pages owned by nobody.

5. Copies fork

The EMEA team duplicates the onboarding checklist to adjust it for their payroll provider. Now there are two, both partly right, and every future change has to be made twice by people who don't know the other copy exists.

6. The wiki isn't where work happens

Work happens in Slack, Teams, meetings and email. The wiki is a separate place people visit when they have time. Any system that depends on people carrying changes from where work happens to where it's written down will lose some of them, and as the company grows it loses more.

What Notion and Confluence already do about it

Both tools have features aimed at this problem, and they're worth turning on. Notion wikis let a page owner verify a page for a set period, and notify the owner when the verification expires. Confluence pages have an owner who can hand ownership on, and admins can reassign owners in bulk when people leave.

These help with ownership and review reminders. What they can't do is tell the owner what changed. A verification reminder says "check this page by Friday". It doesn't say "finance changed this rule in #finance-help on Tuesday, and your page still has the old number." The owner still has to go and find the change, which is the part that doesn't scale.

The alternative: a knowledge base that updates itself

A self-updating knowledge base flips who does the carrying. Instead of people copying changes from where work happens into the wiki, the knowledge base reads those places directly. When a decision is made in a Slack thread, a meeting or an email, the answer it affects is updated, with the message behind it as the source. People stop being transcribers and become reviewers: they settle conflicts and confirm the answers that matter, and that's the only upkeep left.

Static wikiSelf-updating knowledge base
Where content comes fromPages people writeThe docs, chat, email and meetings people already use
What triggers an updateSomeone rememberingA change in a connected source
Who does the workWhoever has timeThe system, with owners settling conflicts
How staleness shows upIt doesn't, until someone gets it wrongA flag to the owner, with the newer source attached
What happens on conflictBoth versions live onBoth shown side by side, settled once
What a reader seesA page, maybe a last-edited dateAn answer with its sources and dates

The operating model

Switching tools isn't the hard part. Switching how knowledge work is divided between people and the system is. Six principles make it work:

  1. Connect sources instead of migrating them. Leave SOPs in Drive and Notion, and decisions in Slack and email. The knowledge base reads them where they are, so nothing new has to be written for it to start.
  2. Organize by topic, not by folder. "Discount approvals" is one topic, whether the rule lives in a doc, a thread or a meeting recap.
  3. Treat the channels where work happens as a source. A decision in #sales-ops is as much a part of the discount approval topic as the SOP is, and usually newer.
  4. Give each topic an owner on the team that runs it. Owners settle conflicts and confirm changes; they don't write pages to keep up.
  5. Put a source and a date on every answer, so readers can check it and trust it on evidence rather than faith.
  6. Measure the conflicts left open, not the pages written. A knowledge base with 400 pages and 30 unresolved conflicts is in worse shape than one with 100 pages and none.

Some things stay human. People still decide policy, settle disagreements, sign off regulated procedures and write the occasional document that doesn't exist anywhere yet. What goes away is the copying.

Where Ingesto fits

Ingesto is a self-updating knowledge base

Ingesto is built on this model. You connect the tools your company already uses once, and Ingesto gathers what's scattered across them into one knowledge base organized by topic, then keeps it in sync as those tools change. A decision in a Slack thread, a new policy in Drive or a change agreed on a Zoom call is picked up and merged into the right topic as it happens.

  • Connects Slack, Microsoft Teams, Gmail, Outlook, Google Drive, Notion, Zoom, Google Meet, spreadsheets and PDFs, with nothing to migrate.
  • Flags conflicts, duplicates and stale pages to the owner of each topic, with both versions side by side.
  • Keeps a source and a date on every answer, so people can check what they're told.
  • Leaves your existing Notion and Confluence pages where they are, and reads them as sources.

How to start without a big migration

You don't need to switch the whole company over at once. Pick one team where wrong answers are expensive and questions are frequent, usually support or operations.

  1. List the 20 questions that team gets asked most, from their Slack channels and from new hires.
  2. Connect the places the answers live: the docs, the wiki, the team's channels and the shared inbox.
  3. Name an owner for each topic and agree they'll settle conflicts within a few days.
  4. Run it for a month and track the conflicts found, how fast they were settled, and whether the same questions still come up in Slack.
  5. Add the next team once the first one trusts the answers.

Sources

Frequently asked questions.

Get started

A self-updating knowledge base that reads the places work actually changes. Ingesto connects to Slack, Microsoft Teams, email, Google Drive and Notion, keeps one knowledge base in sync with them as they change, and flags conflicts to the topic owner, so nobody has to update pages by hand.

Keep reading

Make your knowledge base maintain itself.

Connect your tools once. Ingesto does the upkeep.