Hoe documenteer je een klant-onboarding-workflow in 2026

De meeste CS-teams onder 250 personen hebben geen gedocumenteerde onboarding. Ze hebben een Notion-pagina die in maart 2024 actueel was en een Loom-video die ooit voor één klant werd opgenomen. De rekening valt op twee plekken.

Eerst de agenda. Een typische mid-market CSM houdt vijf onboarding-gesprekken per week. Vijfenveertig minuten per gesprek, buffer inbegrepen. Dat is ruim vijf uur per week aan dezelfde herhaalde conversatie. Op een belaste CSM-kost van 120 000 $ per jaar (ongeveer 110 000 €) kost die herhaling rond de 230 € per week aan zuivere repetitie.

Dan de gemiste activaties. De lezer die op een onuitgelegde stap stuit, geeft op. Het onderzoek van NNGroup over waarom webgebruikers scannen in plaats van lezen is helder: gebruikers scannen eerst en lezen pas daarna, en als de scan niets bruikbaars oplevert, vertrekken ze. De meeste gemiste activaties zijn geen productfouten. Het zijn documentatiefouten. De klant wil, het pad is onduidelijk.

De oplossing is niet "schrijf een betere doc". Het is een recording-first methode die het gesprek van vijfenveertig minuten omzet in een artefact van twaalf stappen. Anneke, een senior CSM bij een Amsterdams SaaS-bedrijf, heeft het patroon in één cyclus toegepast. Het verhaal van hoe zij haar onboarding-Zoom heeft vervangen door precies dit schema toont aan dat het resultaat herhaalbaar is op CS-teams van drie tot dertig personen.

Werk indien mogelijk in een verse klantomgeving. Anneke gebruikte een sandbox-account dat de setup van een dag-één klant nabootste.

Stap 1. Loop het standaardpad terwijl je praat. Neem de workflow exact op zoals je hem in een live Zoom zou doorlopen. Pauzeer niet. Repeteer niet vooraf. Verwoord je redenering bij elke klik. De eerste opname duurt vijfenveertig minuten. Bij de derde poging zit je op achttien minuten.

De foutjes die opduiken zijn nuttig. Het zijn dezelfde foutjes die een echte klant maakt. Laat ze in de eerste cut zitten. De montagepass haalt ze eruit. Wat overblijft, is de mondelinge uitleg van waarom elke stap telt. Dat is precies wat de lezer niet uit de UI zelf kan halen.

Stap 2. Snijd genadeloos. De eerste cut bevat vulling. De lezer heeft er niets aan. Knip elke "ik laat je even zien", elke "zoals je ziet", elke "en nu gaan we". Houd de stap en de reden van de stap. Een goede montagepass duurt dertig minuten voor een gids van twaalf stappen.

De output is kort. Vijfenveertig minuten Zoom worden een gids van twaalf stappen die in twaalf minuten wordt gelezen. Het werk van NNGroup over leesbaarheid en begrip toont dat de voltooiingsgraad daalt naarmate de lengte stijgt, en dat een scanbare structuur het wint van narratieve prozavorm voor referentiecontent. Lengte werkt snel tegen je.

Stap 3. Stuur de gids voor het gesprek. De mail na ondertekening linkt de gids. De Zoom wordt optioneel, gepland op dag vier. De meerderheid van de klanten vraagt er niet om. Wie wel komt, brengt specifieke vragen mee, en dat maakt het gesprek eindelijk nuttig.

De metric om te volgen is self-serve-voltooiing. In het geval van Anneke voltooide 88% van de nieuwe klanten de gids voor de optionele Zoom. De 12% die wel boekte, stelde vragen over integratie-trade-offs en configuratiekeuzes, niet "hoe maak ik een project aan".

Stap 4. Neem alleen de geraakte stap opnieuw op bij UI-wijzigingen. Dit is de eigenschap die het zwaarst weegt. Wanneer engineering een UI-aanpassing shipt, neem je alleen de geraakte stap opnieuw op. Twee minuten werk, geen doc-sprint.

De systemen die updates per stap ondersteunen, zijn de systemen die overleven. De systemen die dat niet doen (Loom, PDF, elk monolithisch artefact) worden elk kwartaal herschreven, totdat het team het opgeeft.

Documentatie rot weg omdat niemand er eigenaar van is. De oplossing: één eigenaar per gids, en één werkcadans. Opnieuw opnemen bij UI-wijziging, anders elk kwartaal nakijken.

Drie patronen die werken.

Eigenaarschap per gids. Elke gids heeft één verantwoordelijke eigenaar. De naam staat in de metadata. Wanneer het onderliggende proces wijzigt, neemt de eigenaar de geraakte stap opnieuw op. Er is geen centrale herschrijver. De COO is geen knelpunt.

Kijkstatistieken sturen de wachtrij. De meeste gids-tools tonen een voltooiingsmetric. Heeft een stap 70% drop-off, dan is die stap kapot of onduidelijk. Herschrijf de geraakte stap, niet de hele gids. Updates gestuurd door kijkstatistieken houden de onderhoudskost evenredig met het verkeer.

Kwartaalreview door de eigenaar. Elk kwartaal opent de eigenaar zijn gids, leest hem alsof hij klant is, en klikt door de live omgeving. Ongeveer 80% van de bibliotheek is al actueel. De 20% die het niet is, wordt opnieuw opgenomen in vijftien minuten per geraakte stap.

De onderhoudskost op twaalf gidsen per CSM, elk kwartaal vernieuwd, komt op ongeveer drie uur per kwartaal per CSM. Vergelijk dat met een halfjaarlijkse documentatie-sprint van een week. De recording-first methode amortiseert de kost.

Werkt je team al met Scribe of Tango en wil je appels met appels vergelijken, kijk dan naar het Scribe-alternatief voor CS-teams. Voor de doellengte van een gids legt de 12-stappen-regel uit waarom lengte falen voorspelt. Wie audit-gevoelige onboardings draait (bijvoorbeeld voor een financiële klant onder AFM-toezicht of een verwerker die onder toezicht staat van de Autoriteit Persoonsgegevens) heeft een schriftelijke, reproduceerbare trace nodig die een Loom alleen niet biedt. Het AICPA-criterium voor SOC 2-rapportage eist precies dat soort schriftelijk bewijs.