Guide
How to document internal processes without anyone writing a manual
Long manuals get written once and never opened again. What works is documenting as little as possible, in the shortest format possible, and capturing what’s already being explained in meetings and channels.
The problem: the process exists, but only in someone’s head
Every company has processes, written or not: onboarding a client, approving an expense, what to do when a delivery fails. While the person who knows is around, it all works. When they go on holiday or change roles, someone spends a morning piecing it together from questions.
The usual fix is a documentation project: someone writes twenty wiki pages, nobody maintains them, and six months later they’re out of date. The team learns the wiki can’t be trusted and goes back to asking in Slack.
How it works with Tessa
- 1
Connect your sources
Meeting minutes, Slack channels (public, and private for their members) and your shared Drive folder.
- 2
Tessa extracts what matters
Decisions, processes with their steps, client and project status, and glossary terms, each linked to its source.
- 3
Update instead of duplicate
If a page on the topic exists, she updates it and saves a version; if not, she creates one.
- 4
People have the final say
If someone edits a page by hand, Tessa stops rewriting it and leaves suggestions to accept or dismiss instead.
What you get
- No documentation projectThe wiki grows from the team’s normal work, not from overtime.
- Every fact has a sourceEach step links to the meeting or thread it came from, so you can check it.
- Permissions respectedA page born in a private channel is visible only to that channel’s members.
- Found when neededThe wiki shows up in search, in chat with Tessa and in meeting prep.
Why manuals fail
It isn’t a lack of goodwill. Manuals fail for three reasons: they take ages to write, nobody owns keeping them current, and they live far from where work happens. Any system that doesn’t solve those three ends the same way, whatever the tool.
The alternative is to flip the order: instead of sitting down to write processes, capture what’s already being explained (in a handover meeting, in a Slack thread answering a new hire) and give it a minimal shape.
Which processes to document first
Don’t document everything. Start with processes that meet any of these conditions:
- Getting it wrong costs money or a client (billing, delivery, incidents).
- Only one person knows how to do it.
- It happens a few times a year and something always gets forgotten (year-end, renewals).
- New hires always ask about it in their first weeks.
A one-page process template
If a page doesn’t fit on one screen, it’s too long. This structure works for almost any process; copy and adapt:
- Process name: verb plus object (“Onboard a new client”).
- Owner: the person who keeps it current, not whoever runs it each time.
- Trigger: what starts it (“a contract is signed”).
- Steps: 3 to 10, each with who does it and in which tool. One step per line.
- Definition of done: the visible outcome (“the client has access and got the welcome email”).
- Common mistakes: what usually goes wrong and how to avoid it.
- Sources and last review: link to the meeting or thread it came from, plus a date.
Capture, don’t draft
Three habits turn everyday work into documentation with no extra effort:
- When someone explains a process in a meeting, the minutes capture the steps, not just “Ana explained how it works”.
- When someone answers a “how do we…” question in Slack, they answer in an open channel, not a DM, so it sticks.
- When a decision changes a process, say explicitly what it replaces (“from now on, expenses under €200 don’t need approval”).
How to keep it alive
A wiki dies when nobody trusts it. To prevent that: give every page an owner, show the last-reviewed date and skim the critical pages once a quarter. If a page is wrong, fix it on the spot rather than telling someone else.
Most importantly: when someone asks something that’s already documented, reply with the link. It’s the only way people learn to look there first.
Example: the template filled in
For example, this is how client onboarding might look at a digital agency. Notice it fits on one screen:
- Process: Onboard a new client. Owner: head of accounts.
- Trigger: the client signs the proposal.
- Steps: create the client’s Slack channel; create their Drive folder from the template; give the assigned team access; book the kickoff meeting; send the welcome email with dates and contacts.
- Done when: the client has the welcome email and the kickoff is in everyone’s calendar.
- Common mistake: forgetting to give folder access to people who weren’t involved in the sale.
How Tessa does it
Tessa turns minutes, Slack channels and documents in your shared Drive folder into a wiki that writes itself. She extracts decisions (what, when, where, and whether they replace an earlier one), processes with their steps and client and project status, and links every page to its sources. New minutes are processed within minutes; channels and documents once a day.
She never uses people’s email, direct messages or private conversations with Tessa, and each page is visible only to people who could see all of its sources. If you already use Notion, Tessera can sit alongside it (integration in beta).
What Tessa reads for each person stays private, your data is stored in the EU and nothing goes out without your approval.
Frequently asked questions
How do you document a business process?
With one short page: name, owner, trigger, 3 to 10 steps with who does each, a definition of done and common mistakes. Start with critical processes or ones only a single person knows.
What tool should I use to document processes?
Whatever your team already opens every day. Having documentation close to the work and owned by someone matters more than the tool: a shared doc, Notion or a wiki can all work.
How do I stop an internal wiki going stale?
Give every page an owner, show the review date and feed the wiki from where decisions are made: meetings and channels. A wiki that updates itself with sources needs far less upkeep.
Does Tessa read my email to write the wiki?
No. The wiki is fed only by minutes, Slack channels and documents in the shared Drive folder. Personal email, direct messages and conversations with Tessa never go in.
Can I edit what Tessa writes in the wiki?
Yes. Your edits win: once you edit a page, Tessa stops rewriting it and proposes suggestions you can accept or dismiss. Every change keeps a version.
Keep reading
- FeaturesYour company wiki, written while you workDecisions, processes and “how we do things here” pulled from meetings and channels, with sources and the right permissions. Try it free today.
- GuidesHow to write meeting minutes: a guide and a template to copyWrite clear meeting minutes: what to include, how to word decisions and action items, plus a ready-to-copy template you can start using today.
- FeaturesEvery new hire starts with a plan, not a “just ask if you need anything”Every new hire gets a message from Tessa with who's who, key clients, processes and their welcome checklist, plus someone to ask. Try it free.
- FeaturesOne search box for everything at your companySearch your email, Slack, meeting minutes, docs, tasks and contacts at once, and get answers from Tessa with every source cited. Try it free.
- IntegrationsA Slack AI assistant that reads the channels for youMention @Tessa to create tasks, summarise threads or ask what was agreed. Requests aimed at you land in your inbox and close themselves once you reply.
- GuidesWhat breaks when you go from 10 to 50 people (and how to avoid it)What breaks when you grow from 10 to 50 people: communication, decisions, context, onboarding and processes. Warning signs and what to do about each.
What does your team look like?
Same AI for both. Where you start is what changes.
- Best fit for this page
Companies
30 to 250 people
What gets decided gets done
Minutes and tasks from every meeting, commitments that get followed up and a pulse per team, without watching anyone.
Startups
5 to 30 people
Grow without losing the thread
Tasks from email and Slack, follow-ups, sales and investors, without everything landing on the founders.
Connect Slack and your meetings, and see which processes show up in your wiki this week.
Start freeFree plan for teams of up to 3 people. Anything that leaves the company waits for your approval.