BlogWorkflow-documentatie · Playbook
Workflow-documentatie · Playbook

Stapsgewijze handleidingen: zes teams, één patroon

De senior collega die de workflow uit het hoofd kent, wordt het knelpunt. De wiki rot weg. De Loom die niemand bekijkt verzamelt stof in een map. Stapsgewijze handleidingen breken dat patroon in de zes teams die we het in productie hebben zien doen.

Portrait of Charles Krzentowski
Geschreven door
Charles Krzentowski
Co-founder, Capture
Gepubliceerd
Een centrale handleiding-kaart met zes stralende verbinders naar kleine isometrische iconen (doel, server, klembord, ID-badge, koffer, laptop), brutalistische redactionele illustratie die één methode voor zes teams suggereert
De cijfers
CS-onboarding
12 min
45 min
Per klant
IT-tickets niveau 1
−35%
In 8 weken
Ramp-up nieuwe engineer
1 week
3 weken
Tot eerste PR
Uplift per bureau-opdracht
4.500 €
Toegevoegde factuurregel
In 60 seconden

De korte versie.

Workflow-handleidingen winnen omdat ze kennis loskoppelen van de persoon die haar draagt. De senior CSM die de onboarding leidt, de staff engineer die de dev-omgeving kent, de COO die de SOP-bibliotheek heeft gebouwd, de People Ops-lead die nieuwe collega's door hun eerste week loodst: ieder van hen kan in twaalf minuten per workflow worden vermenigvuldigd. De teams die dit doorhebben, schalen op gedocumenteerde processen. De andere teams schalen mee met de beschikbaarheid van één senior, wat neerkomt op niet schalen. Dit is het playbook dat zes van die teams hebben gebruikt.

01 · Sectie

Waarom workflow-handleidingen winnen in 2026

De teams die voorbij één auteur schalen, delen een structureel inzicht: een handleiding is geen beschrijving, het is een opname. De wiki-pagina is een beschrijving. De Loom-video is een beschrijving plus een gezicht. De Notion-SOP is een beschrijving in een ander jasje. De workflow opnemen terwijl hij draait, levert een ander artefact op: een stapsgewijs spoor van wat is geklikt, in welke volgorde, met de redenering van de operator vastgelegd.

Dat verschil telt, want beschrijvingen verouderen sneller dan opnames. Een beschrijving verwijst naar een interface. De interface krijgt een update, de beschrijving klopt niet meer. Een opname verwijst naar gedateerd schermbewijs, en alleen de geraakte stap wordt in twee minuten opnieuw opgenomen wanneer de interface verandert. De economie van het onderhoud kantelt.

Een tweede reden waarom handleidingen specifiek in 2026 winnen: de teams die de documentatie schrijven zijn kleiner dan de teams die haar lezen. Een CS-functie van vier personen levert handleidingen die 200 klanten in hun eigen taal consumeren. Een IT-team van drie personen levert handleidingen die 1.000 medewerkers gebruiken om geen ticket te openen. De asymmetrie tussen schrijver en lezer is het hele spel. Alles wat de schrijfkost per handleiding verlaagt, stapelt op. Alles wat de onderhoudskost van een bestaande handleiding verhoogt, stapelt tegen je op.

Het onderzoek van Nielsen Norman Group naar waarom webgebruikers scannen in plaats van lezen onderbouwt de keuze voor het format. De lezer scant eerst, leest daarna. Stapsgewijze handleidingen scannen goed. Lange lappen tekst niet. Loom-video's zijn helemaal niet te scannen. Wie wil duiken in waarom een te lange handleiding een halfgelezen handleiding is, vindt de cijfers in de twaalf-stappen-regel over lengte en falen.

02 · Sectie

Zes contexten waar handleidingen de rekening kantelen

De zes teams hieronder zijn samengestelde scenario's, getrokken uit patronen die we bij klanten zagen. De cijfers zijn echt, de namen en herkenningsdetails zijn aangepast. Elk team had een andere workflow, hetzelfde probleem, en dezelfde oplossing.

Customer Success: de Zoom-onboarding die verdween. Anneke, senior CSM bij een mid-market B2B SaaS, verving een onboarding-gesprek van vijfenveertig minuten door een opgenomen handleiding van twaalf minuten. De self-serve voltooiing kwam uit op 88%. De wekelijkse gesprekslast voor onboardings ging van vijf uur naar één. Het portfolio groeide van vijftig naar negentig accounts zonder een extra CSM. Het volledige verhaal staat in het klantsucces-onboarding-verhaal en in de gids voor het documenteren van de klant-onboarding-workflow.

IT-operations: de niveau-1 ticketrij die ophield met vollopen. Een scale-up van 220 mensen heeft de twintig vaakst herhaalde vragen omgebouwd tot Capture-handleidingen, gelinkt vanuit de helpdesk-Slackbot. Het ticketvolume op niveau 1 zakte met 35% in acht weken. De mediane oplostijd ging van 22 minuten naar 6. Het IT-team kreeg zijn maandagen terug. Twintig handleidingen die 70% van het historische ticketvolume dekten, vroegen elk een halve dag aan opname. Lees het IT-helpdesk-patroon en het Tango-alternatief voor IT-teams voor de rekensom op de toolkant.

Operations en SOC 2-SOPs: audit-klaar uit zichzelf. Een B2B-fintech van 38 personen herbouwde haar SOP-bibliotheek voor SOC 2 in zes weken. Eenentwintig handleidingen, opgenomen door de proceseigenaars, met getimede klikken en schermbewijs ingebakken. De auditor sloot twee weken eerder af. De Trust Services Criteria van AICPA zijn ondubbelzinnig over wat auditors willen: bewijs van uitvoering, geen beschrijving van beleid. Opnames zijn bewijs. Het patroon staat uitgewerkt in het SOC 2 audit-klare SOPs-playbook.

People Operations: rolgebaseerde inwerktrajecten die niet meer van de manager afhangen. Een creatief bureau van 75 personen verving zijn ad-hoc eerste-dag-playbooks door playlists van vijf tot acht handleidingen per rol: designer, account manager, ontwikkelaar. De stack-readiness op dag 2 kwam uit op 100%. De CSAT van nieuwe collega's ging van 3,2 naar 4,7. De People Ops-Slackinbox zakte van twaalf onboarding-DMs per dag naar twee. Het verhaal leeft in de rolgebaseerde inwerk-playlists.

Bureau-oplevering: de overdracht als factuurregel. Een digitaal productbureau van 14 personen liet elke opdracht eindigen met een Capture Pack: acht tot twaalf handleidingen die het live systeem dekken, opgenomen tijdens het project. De overdracht hield op met een vrijdagavond-spurt te zijn. Het verlengingspercentage steeg van 67% naar 92% over vier opdrachten. De pack voegde 4.500 € toe aan de gemiddelde opdrachtprijs. Het complete verhaal staat in de bureau-overdracht-case.

Engineering: de README die twaalf handleidingen werd. Bram, staff engineer bij een B2B-observability-platform, verving een README van 2.400 regels over de dev-omgeving door twaalf opgenomen handleidingen die installatie, bekende faalmodi en het on-call-runbook dekken. De tijd tot eerste gemergde PR voor nieuwe engineers ging van drie weken naar één. Het volume DMs aan senior engineers in week 1 zakte van zes per nieuwe medewerker naar één. Het verhaal staat in de engineering-onboarding-case, en de diepere oorzaken vind je in waarom README-gebaseerde engineering-onboarding altijd rot.

De vorm herhaalt zich: een senior persoon neemt eenmalig op, het team consumeert de opname, de onderhoudslus loopt stap voor stap. De kostencurve kantelt voor elk team dat het patroon overneemt.

03 · Sectie

De methode in vier stappen

Alle zes teams hierboven gebruikten een variant op dezelfde vier stappen. Er zit geen creatieve daad in de opname zelf; de creativiteit zit in de keuze wat je opneemt en hoe vaak je het ververst.

Stap 1. Loop het standaardpad terwijl je praat. Neem de workflow op precies zoals je hem zou doorlopen op een live Zoom. Pauzeer niet. Repeteer niet vooraf. Verwoord de redenering terwijl je klikt. De eerste opname duurt vijfenveertig minuten, de derde vijftien.

Stap 2. Knip meedogenloos. De eerste versie zit vol vulling. Knip elke "ik laat je even zien", elke "zoals je kunt zien", elke "en dan gaan we nu naar". Houd de stappen en de reden voor elke stap over. Dertig minuten editen voor een handleiding van twaalf stappen is normaal. Hoe korter de handleiding, hoe meer hij gelezen wordt.

Stap 3. Distribueer via het kanaal dat al bestaat. De mail na ondertekening voor CS. De Slackbot voor IT. De auditmap voor compliance. De dag-0-mail voor People Ops. Documentatie achter een wiki-login is documentatie die niet bestaat. NNGroup-data over het F-vormige leespatroon is consistent: als een lezer niet binnen 90 seconden kan beslissen of de handleiding zijn vraag beantwoordt, vertrekt hij. Maak hem makkelijk te vinden en makkelijk te scannen.

Stap 4. Neem één stap opnieuw op als de UI verandert. Dit is de eigenschap die werkende systemen scheidt van rottende. Wanneer de onderliggende interface een update krijgt, wordt de geraakte stap in twee minuten opnieuw opgenomen. Geen documentatiesprint. Geen wiki-herschrijving. Eén stap.

De teams die het onderhoud in de opnamemethode zelf inbouwen, blijven actueel. De teams die documentatie als een eenmalig project behandelen, leveren acht weken iets nuttigs en zien daarna het bouwwerk afbrokkelen. De gedetailleerde mechaniek staat in de documentatiegids voor klant-onboarding. Wie de methode zonder verplichting wil testen, kan vandaag nog de Capture-extensie installeren op Chrome en de eerste handleiding deze middag opnemen.

04 · Sectie

Wat een handleiding actueel houdt of laat verouderen

Zes eigenschappen scheiden de handleidingen die een jaar overleven van die welke in maart stilletjes worden gearchiveerd. Mist een documentatiesysteem er meer dan twee, reken dan op rot in maand vier.

Eigenschap
Scanbaar in 90 seconden
Waarom dit telt
Kan de lezer niet binnen 90 seconden vaststellen of de handleiding zijn vraag beantwoordt, dan leest hij niet verder. Aantal stappen, kopjes, geschatte leestijd: alles boven de vouw.
Eigenschap
Schermbewijs op elke stap
Waarom dit telt
Tekstbeschrijvingen verouderen sneller dan screenshots. Een screenshot van vorig kwartaal is verifieerbaar, een zin niet.
Eigenschap
Bijwerken stap voor stap
Waarom dit telt
De onderhoudskost van een handleiding wordt bepaald door hoe makkelijk je één stap kunt veranderen zonder het hele ding opnieuw op te nemen. Dat is de sterkste voorspeller voor de versheid op maand vier.
Eigenschap
Doorzoekbaar in de pagina
Waarom dit telt
Cmd+F is de universele inhoudsopgave. Een handleiding opgeslagen als video of achter een login zakt voor deze test.
Eigenschap
Werkt zonder de auteur
Waarom dit telt
De senior persoon die hem opnam, moet vervangbaar zijn. De bibliotheek erft, het institutionele geheugen niet.
Eigenschap
Heeft één benoemde eigenaar
Waarom dit telt
Een handleiding zonder eigenaar rot in twaalf weken weg. Een handleiding met eigenaar wordt ververst wanneer het proces verandert.

Een Notion-pagina haalt scanbaarheid en zoekbaarheid, maar zakt op schermbewijs en stap-voor-stap-update. Een Loom-video zakt op scanbaarheid, zoekbaarheid en stap-voor-stap-update. Een PDF uit 2023 zakt op schermbewijs en het bijwerken per stap. Het patroon dat alle zes haalt: opgenomen handleidingen met een benoemde eigenaar. Het NNGroup-onderzoek over leesbaarheid, leesgemak en begrip versterkt het punt: een formaat dat het oog op elke stap meer dan drie seconden laat zoeken, is een formaat dat afgehaakt wordt.

05 · Sectie

Een tool kiezen: vijf vragen

De meeste teams die op zoek zijn naar een documentatietool stellen de verkeerde vragen. Ze vragen naar features. De vragen die beslissen of de bibliotheek op maand vier nog actueel is, zijn andere.

  1. Ondersteunt de editor stapsniveau-updates? Wanneer de UI verandert, kan dan één stap opnieuw worden opgenomen zonder de rest van de handleiding te raken? Capture, Scribe, Tango en Dubble doen dit. Loom niet.

  2. Is gegenereerde voice-over op de gepubliceerde handleiding meegeleverd? Gegenereerde stem (niet alleen opgenomen audio) geeft de asynchrone lezer hetzelfde als een Loom, in een tiende van de scantijd. Capture levert dit op het Free-plan, anderen sluiten het op in hogere paliers of hebben het niet.

  3. Is meertalige output bij het teamplan inbegrepen? Lokalisatie wordt op de meeste documentatietools als Enterprise-feature behandeld. Capture levert het op Free. De volledige leveranciersvergelijking staat in de beste Scribe-alternatieven van 2026.

  4. Kunnen branded PDF's op elk plan worden geëxporteerd? Klanten, auditors en enterprise-lezers houden meestal de PDF. Als branded export een betaalde-tier-feature is, stapelt de kost zich snel op.

  5. Wat is het minimum op het teamplan? Capture is drie zetels. Scribe is vijf. Tango is drie. Het minimum bepaalt of een CS-team van vier mensen een extra zetel betaalt of op Pro Persoonlijk blijft.

Pas die vijf toe op elke shortlist van documentatietools en het antwoord versmalt snel. De diepe één-tegen-één-vergelijkingen vind je in het Scribe-alternatief voor CS-teams en het Tango-alternatief voor IT-teams. Wie de hele rasterkaart wil zien, vindt zetels en functies per palier op de prijspagina.

06 · Sectie

De rekening: gewonnen uren per teamtype

Het cijfer dat beslist of de documentatie zich terugbetaalt is de asymmetrie tussen schrijver en lezer. Een handleiding die in twee uur wordt geschreven en door 200 klanten in hun eigen taal wordt gelezen heeft een andere ROI dan een Notion-pagina van vijf uur die door twaalf interne medewerkers wordt gelezen.

Teamtype
Customer Success (mid-market B2B)
Geïnvesteerde uren per handleiding
1,5
Lezers per handleiding per maand
60-100
Gewonnen uren per maand
8-15
Teamtype
IT-helpdesk (scale-up van 200 personen)
Geïnvesteerde uren per handleiding
1,5
Lezers per handleiding per maand
80-150
Gewonnen uren per maand
6-12
Teamtype
Operations (SOC 2-SOPs)
Geïnvesteerde uren per handleiding
2
Lezers per handleiding per maand
5-10 (auditors plus intern)
Gewonnen uren per maand
1-2, plus dividend op het audit-window
Teamtype
People Operations (HR mid-market)
Geïnvesteerde uren per handleiding
1
Lezers per handleiding per maand
8-15 (nieuwe collega's)
Gewonnen uren per maand
1-2
Teamtype
Bureau-overdracht
Geïnvesteerde uren per handleiding
4
Lezers per handleiding per maand
1-3 (klantteam)
Gewonnen uren per maand
0 (omzet, geen tijd)
Teamtype
Engineering-onboarding
Geïnvesteerde uren per handleiding
2
Lezers per handleiding per maand
3-6 (nieuwe collega's per kwartaal)
Gewonnen uren per maand
8-15 (vermeden DMs aan seniors)

Customer Success en IT hebben de hoogste lezer-per-handleiding-ratio, en daarom betalen die twee contexten zich het snelst terug. Operations betaalt zich terug op het audit-window. People Ops betaalt zich terug in retentie en CSAT. Het bureau betaalt zich terug in verlengingspercentage en uplift per opdracht. Engineering betaalt zich terug in seniortijd. Verschillende tijdschalen, dezelfde asymmetrie.

Voor wie naar een Nederlandse referentie wil kijken: een Mollie-achtig CS-team van vier mensen dat 200 SaaS-klanten bedient via gelokaliseerde handleidingen, of een Adyen-achtig fintech-ops-team dat onder AVG en SOC 2 audits draait, ziet dezelfde rekensom. Een Bynder-CSM die overdrachtsdocumentatie maakt voor agencies die aan brand-portals werken, ook. Een Picnic-ops-coördinator die zijn distributiecentra wil doortrekken naar nieuwe regio's zonder elke supervisor zelf op te leiden, idem. Of een Booking.com-engineer die een nieuwe deploy-procedure wil verspreiden over zes squads zonder voor elk een eigen brownbag te organiseren. Het patroon is niet contextafhankelijk, het schaalt op de asymmetrie tussen schrijver en lezer.

De teams die hierin slagen, zijn de teams die de juiste eerste handleiding kiezen. Pak de workflow die je vijf keer per week uitlegt. Neem hem één keer op. Kijk hoe hij ophoudt uitgelegd te worden. Die eerste keuze weegt zwaarder dan de kwaliteit van de tiende handleiding. Wie wil zien hoe een Mollie-CSM dit deed, vindt het volledige verhaal in het klantsucces-inwerken-verhaal.

In elk team dat ik bij Apple van dichtbij zag, rotte de documentatie in hetzelfde tempo: ongeveer acht weken. De teams die dat patroon doorbraken deden één ding anders. Ze stopten met schrijven.
Charles Krzentowski, ex-Apple Zuid-Europa
FAQ

Veelgestelde vragen.

Welke teams profiteren het meest van workflow-handleidingen?

Elk team waar dezelfde workflow meer dan drie keer door dezelfde senior persoon wordt uitgelegd. De Customer Success- en IT-contexten betalen zich het snelst terug omdat de lezer-per-handleiding-ratio het hoogst is. Operations en engineering betalen zich op andere tijdschalen terug (audit-window, ramp-up van nieuwe collega's). De verkeerde fit: eenmalige processen die twee keer draaien en daarna niet meer.

Hoe lang duurt het om een bibliotheek van 10 handleidingen te bouwen?

Een klein team levert zijn eerste tien handleidingen meestal in één werkweek op. De eerste handleiding kost negentig minuten (vijfenveertig opnemen, dertig editen, vijftien voor screenshots en metadata). De tweede kost een uur. Bij handleiding vijf zit de meeste operator op vijfenveertig minuten totaal per handleiding. Het patroon stapelt op omdat het edit-instinct sneller schaalt dan de opname-vaardigheid. De gedetailleerde timing staat in de documentatiegids voor klant-onboarding.

Kunnen handleidingen video volledig vervangen?

Voor herhaalbare workflow-documentatie bijna altijd ja. Voor asynchrone vergaderopnames, sales-demo's en eenmalige aankondigingen waar gezicht en stem de boodschap dragen, blijft video het juiste formaat. De verkeerde inzet (video voor documentatie) creëert een onderhoudskost die de gewonnen opnametijd snel inhaalt. De meeste teams die Loom voor documentatie gebruiken, migreren binnen zes maanden. Voor de cijfers achter die migratie biedt Scribe Library een uitgebreide referentie van use-cases waar handleidingen video vervangen.

En voor echt technische workflows zoals engineering-installatie?

Engineering is meer beladen met faalmodi dan de onboarding van zakelijke gebruikers. Documenteer de pannes, niet alleen het gelukkige pad. Het patroon dat werkte voor Bram in de engineering-onboarding-case: elke bekende faalmodus krijgt zijn eigen korte troubleshooting-handleiding, gelinkt vanuit de hoofdgids. De structuur van de bibliotheek weegt zwaarder dan het aantal handleidingen.

Hoe verschilt dit van een wiki of Notion?

Wikis en Notion zijn documentatie-oppervlakken, geen capture-tools. Teams die ze voor workflow-documentatie inzetten, schrijven de stappen meestal handmatig en maken voor elke stap een screenshot. De onderhoudskost is hoog (elke UI-wijziging vereist handmatige screenshot-vervanging en tekstherschrijving) en het artefact heeft geen stem, geen AI-herschrijving en geen meertalige output. De combinatie Notion plus Loom is in DIY-vorm de echte concurrent van de toegewijde capture-tools, en dezelfde migratierekensom geldt: de meeste teams stappen binnen zes maanden over zodra de onderhoudskost begint op te stapelen.

Volgende stap

Klaar om deze week de eerste tien handleidingen van je team op te nemen?

Capture is gratis tot drie handleidingen op de Chrome-extensie. Het Team-plan begint bij drie zetels, 12 $ per zetel per maand, met stem en meertalige output op elke palier. De meeste teams leveren hun eerste tien handleidingen in één werkweek.

Probeer het

Neem één workflow op.

Gratis Chrome-extensie. Geen registratie nodig.