All guides
Guide6 min read

How to keep process docs up to date when workflows change

New tools, CRM fields and approval steps land every week, and the docs never hear about it. Five steps to keep them current without it eating your job.

Sami SIngesto

The short answer

Describe each step of a process in one place and link to it everywhere else. Catch changes where they're announced, like a Slack message, a meeting or an email, instead of waiting for a review. When something changes, search for the old wording to find every doc that still describes it, and send each one to an owner on the team that runs the process. Keep screenshots to a minimum, since they go stale first. Ingesto does the catching and finding for you: it reads the chat, email and meetings where changes happen and flags every doc that still describes the old way to its owner.

The example we'll use

On Monday, sales ops adds an approval step: any discount over 15% now needs sign-off from finance in the CRM before the quote goes out. They post it in #sales-ops, change the CRM, and move on.

The quoting SOP still says reps can send anything under 20% on their own. So does the sales onboarding deck, the Notion page the new reps use, two internal FAQs, a screenshot walkthrough of the old quote screen, and the reply support pastes when a customer asks why their quote is taking so long. Nobody edited any of them, because nobody had a list of where the rule was written down.

How often things change is usually not what breaks the docs. What breaks them is that each change is announced in one place and written down in a dozen others. The steps below deal with that.

Step 1: Describe each step in one place, and link to it everywhere else

The discount rule ended up in seven places because each one copied it. Every copy is one more place that will be wrong after the next change.

Pick one home for each step of a process, usually the SOP for that process, and have everything else link to it. The onboarding deck says "follow the quoting process" with a link, instead of restating the discount limits. When the rule changes, you edit one page.

You won't get to zero copies. Training material and customer-facing FAQs will always repeat some of it. But going from seven copies to two means the next change is two edits instead of seven.

Step 2: Catch changes where they're announced

Changes almost never start in the documentation. They start as a Slack message from sales ops, a decision in a Tuesday meeting, a new field someone added to the CRM, or an email from finance. The docs only change if someone remembers to go and edit them.

So make the announcement do the work. Agree that any change to how work gets done is posted in one channel, with a line on what changed and when it starts. It doesn't need a template. "From Monday, discounts over 15% need finance approval in the CRM" is enough. Whoever looks after the docs then watches one channel instead of all of them.

People will still change things without saying so. But most changes go from something you find out about weeks later to something you see the day it happens.

Step 3: Find every doc that still describes the old way

When a change lands, search for the old version, not the new one. Look through your wiki and shared drives for the words the old process used: "20%", "manager approval", the old field name. That list is your to-do list for this change.

For each result, fix it, or replace the copied text with a link to the page from step 1. If a doc is one nobody would miss, archive it. It's only there to be wrong later.

Where Ingesto fits

How Ingesto handles steps 2 and 3

Watching every channel and searching every doc after every change is the part that eats the job. Ingesto does it for you. It reads the Slack, Teams and email where changes get announced, and the documents your procedures already live in. When sales ops posts the new approval rule, Ingesto finds the SOP, the onboarding deck and the Notion page that still say 20%, and sends each one to its owner with the message that changed it.

  • Picks up process changes from Slack, Microsoft Teams, Gmail, Outlook, and Zoom or Google Meet calls.
  • Reads procedures where they already are, in Google Drive, Notion, Word, PDFs and spreadsheets. Nothing has to be moved or rewritten.
  • Flags every doc that contradicts a newer change to its owner, with both versions side by side.
  • Finds copies of the same procedure that have drifted apart, so you can collapse them into one.
  • Gives your team one place to ask how something works today, with the source and date behind each answer.

Step 4: Use fewer screenshots

Screenshots go stale first, and they're the hardest to catch because search can't read them. A picture of the old quote screen looks just as sure of itself as a new one.

Keep them for screens that are genuinely hard to describe. Everywhere else, name the field and the button in the text ("set Discount approval to Finance"), so a search for that field finds the doc the next time it changes. When you do keep a screenshot, put the date under it so readers can tell how old it is.

Step 5: Give each doc an owner on the team that runs the process

If you're the one person who owns "SOPs", you've been handed every process in the company, including the ones you don't run. You'll always be the last to hear about a change.

Give each doc an owner on the team that does the work: the quoting SOP belongs to sales ops, the returns SOP to the support lead. Your job becomes running the system, meaning the channel, the search and the list of owners, rather than keeping every page right yourself. When something goes stale, you know exactly who to send it to.

Frequently asked questions.

Get started

Describe each step in one place and link to it, catch changes where they're announced, and when something changes, search for the old wording to find every doc that still describes it. Ingesto automates this: it watches Slack, Teams, email and meetings for process changes and flags every doc that still describes the old way to its owner.

Keep reading

Make your knowledge base maintain itself.

Connect your tools once. Ingesto does the upkeep.