Elke documentatiebeslissing — wat te bevatten, hoeveel uit te leggen, welke woorden te gebruiken — komt voort uit één enkele bron: een duidelijk begrip van voor wie je schrijft. Zonder dat raad je maar wat. Hiermee heb je een betrouwbaar filter voor elke keuze die je maakt.
Je publiek is tegenwoordig breder dan vroeger. Het bevat nog steeds de menselijke lezer die iets voor elkaar probeert te krijgen, maar het omvat nu ook zoekmachines, antwoordmachines en AI-assistenten die je documentatie namens die persoon lezen — en soms een antwoord geven zonder het ooit naar het artikel te sturen. Een volledige publieksdefinitie houdt rekening met beide.
Dit artikel legt uit hoe je je publiek kunt identificeren en beschrijven, en hoe je dat begrip kunt gebruiken om documentatie te schrijven die echt nuttig is voor de mensen — en systemen — die het nodig hebben.
Waarom publieksdefinitie belangrijk is
Hetzelfde onderwerp kan op totaal verschillende manieren worden gedocumenteerd, afhankelijk van wie er leest. Een artikel over het instellen van gebruikersrechten ziet er bijvoorbeeld heel anders uit wanneer het is geschreven voor een systeembeheerder dan voor een beginnende gebruiker. De beheerder heeft precisie en randgevallen nodig. De eerste gebruiker heeft context, geruststelling en duidelijke stappen nodig.
Schrijven voor "iedereen" betekent bijna altijd schrijven voor niemand, goed. Als je probeert elke mogelijke lezer in één artikel te bedienen, overweldigen jullie beginners met details of saaie experts met uitleg die ze niet nodig hebben.
Hoe je je publiek beschrijft
Een nuttige beschrijving van het publiek beantwoordt vier vragen.
Wat weet je lezer al?
Identificeer de basiskennis die je lezer meebrengt naar het artikel. Dit bepaalt hoeveel je moet uitleggen en welke termen je zonder definitie kunt gebruiken.
Een lezer zonder achtergrond in jouw vakgebied heeft termen gedefinieerd, concepten geïntroduceerd en stappen gedetailleerd moeten worden uitgesplitst. Een lezer die dagelijks in het veld werkt, heeft daar niets van nodig — ze hebben precieze, efficiënte informatie nodig die hun expertise respecteert.
Wees specifiek. "Technische gebruikers" is niet nuttig. "Softwareontwikkelaars die bekend zijn met REST API's maar nieuw zijn met authenticatieflows" is dat.
Wat probeert je lezer te bereiken?
Lezers komen bij documentatie met een doel. Ze willen een taak voltooien, een probleem oplossen of een concept begrijpen. Als je hun doel begrijpt, zie je welke informatie in het artikel hoort en wat ruis is.
Vraag de aflevering: hoe ziet succes eruit voor deze lezer? Wanneer ze dit artikel sluiten, wat zouden ze moeten kunnen doen wat ze eerder niet konden?
In welke context bevindt je lezer zich?
Context bepaalt hoe lezers lezen. Een lezer die midden in een gefrustreerde probleemoplossingssessie zit, leest anders dan iemand die uit nieuwsgierigheid een functie onderzoekt. Een lezer op een mobiel apparaat tijdens een vergadering leest anders dan iemand aan een bureau met twee monitoren.
De context vertelt je hoeveel geduld je lezer heeft, hoeveel details ze kunnen opnemen en hoe dringend ze een antwoord nodig hebben.
Wat weet je lezer niet dat hij moet weten?
Dit is vaak de belangrijkste vraag, en de moeilijkste om te beantwoorden. De hiaten in de kennis van een lezer zijn niet altijd duidelijk — vooral als je zelf een expert bent op het gebied. Dit is de "vloek van kennis": hoe meer je over iets weet, hoe moeilijker het is om te herinneren hoe het was om het niet te weten.
Pak dit tegen door echte lezers bij je documentatieproces te betrekken. Gebruikerstesten, supportticketanalyse en directe gesprekken met klanten zijn allemaal effectieve manieren om te ontdekken wat mensen echt niet weten.
Doelgroepniveaus naar expertise
De meeste kennisbases bedienen meer dan één doelgroep. Een veelvoorkomend patroon is het hebben van drie verschillende lezersgroepen, elk met een andere aanpak.
Beginners
Beginners zijn niet vertrouwd met het product, het domein, of beide. Ze hebben eerst introductie nodig voordat ze instructie krijgen. Ze profiteren van conceptuele overzichten die uitleggen wat iets is voordat ze uitleggen hoe het gebruikt moet worden. Ze hebben vereisten duidelijk uitgelegd, stappen duidelijk genummerd en uitkomsten expliciet vermeld zodat ze weten wanneer ze geslaagd zijn.
Beginners worden gemakkelijk ontmoedigd door onverklaarbaar jargon, stappen die vooruit springen, of artikelen die context aannemen die ze niet hebben. Elke onverklaarde aanname is een potentieel uitgangspunt.
Intermediaire gebruikers
Gevorderde gebruikers kennen de basis en breiden hun gebruik van het product uit. Ze hebben geen begeleiding nodig, maar wel volledige informatie. Zij zijn vaak de grootste groep in een kennisbank en het moeilijkst om goed voor te schrijven, omdat hun behoeften het meest gevarieerd zijn.
Intermediate gebruikers profiteren van duidelijke, directe, taakgerichte content die snel ter zake komt en voldoende context biedt om het waarom achter elke stap te begrijpen.
Gevorderde gebruikers
Geavanceerde gebruikers — beheerders, ontwikkelaars, power users — kennen het product diepgaand en hebben precieze, gedetailleerde informatie nodig. Ze onderzoeken vaak randgevallen, integreren met andere systemen of lossen complexe problemen op.
Gevorderde gebruikers raken gefrustreerd door overmatige uitleg en onnodige inleiding. Ze willen technische nauwkeurigheid, volledige parameterreferenties en eerlijke erkenning van beperkingen. Ze tolereren dichtheid als dat precisie betekent.
Publieksniveaus op zichtbaarheid
Naast expertise varieert het publiek ook door wie de inhoud überhaupt mag bekijken. Dit beïnvloedt niet alleen de toon, maar ook de structuur, diepte en of zoek- en AI-vindbaarheid überhaupt van toepassing zijn.
Openbare documentatie
Openbare documentatie is beschikbaar voor iedereen, ook voor mensen die nog geen klant zijn. Het moet werken voor lezers die zonder context aankomen, en het moet vindbaar zijn — wat betekent dat SEO, AEO en GEO allemaal direct van toepassing zijn:
- SEO: het artikel moet scoren op basis van de termen die een potentiële of bestaande gebruiker zou zoeken.
- AEO: het artikel heeft een duidelijk, te extraheren antwoord bovenaan nodig, omdat het als fragment kan worden weergegeven of hardop kan worden voorgelezen door een spraakassistent voordat de lezer doorklikt.
- GEO: het artikel moet zo gestructureerd zijn dat een AI-assistent het nauwkeurig kan ophalen en citeren wanneer een gebruiker dezelfde vraag stelt aan een algemene chatbot.
Openbare inhoud moet een zo breed mogelijk scala aan voorkennis aannemen en mag nooit vertrouwen op interne terminologie.
Private (interne) documentatie
Privédocumentatie is beperkt tot werknemers, partners of een gedefinieerd intern publiek. Het kan veilig uitgaan van gedeelde context, interne woordenschat en eerdere training — waardoor het dichter en efficiënter wordt. Vindbaarheid gaat hier over interne zoekmachines, niet over publieke zoekmachines: SEO en GEO voor publieke AI-systemen zijn irrelevant, maar interne AI-assistenten (als jouw organisatie die gebruikt) profiteren nog steeds van dezelfde duidelijke structuur en consistente terminologie die publieke GEO helpt.
Privédocumentatie kan het zich veroorloven om de indeling die publieke inhoud nodig heeft over te slaan, maar ze mag precisie niet overslaan — een intern publiek onder tijdsdruk is nog steeds een publiek dat bij de eerste lezing moet slagen.
Documentatie voor gemengde doelgroepen
Sommige content — prijspagina's, beveiligingsoverzichten, integratiegidsen — is geschreven voor een gemengd publiek: deels publiek, deels geauthenticeerde klant, soms deels intern. Dit is de moeilijkste laag om voor te schrijven, omdat hetzelfde artikel mogelijk een potentiële klant die het product onderzoekt, een bestaande klant die het configureert en een supportmedewerker het oplossen moet bevredigen.
Voor gemengde doelgroepen begin je met wat de breedste groep nodig heeft (meestal het publieke "wat is dit en waarom zou ik het gebruiken") en voeg je steeds specifiekere details toe voor de kleinere groepen, in plaats van te proberen de inhoud te middelen tot iets te vaags voor iedereen.
Schrijven voor meerdere doelgroepen
Wanneer een enkel artikel meer dan één publiek moet bedienen, structureer het dan zo dat elke groep — mens of AI — kan vinden wat ze nodig hebben zonder door content te worstelen die niet voor hen is.
Een effectieve aanpak is om te beginnen met de essentiële informatie die alle lezers nodig hebben, en vervolgens steeds gedetailleerdere informatie toe te voegen. Beginners stoppen zodra ze hebben wat ze nodig hebben; Gevorderde gebruikers gaan verder in de details. Deze laagvorming is ook precies wat AEO en GEO ten goede komt: een duidelijk antwoord voor extractie, ondersteunend detail hieronder voor lezers die het willen.
Een andere aanpak is om de inhoud volledig te scheiden: houd een beginnersversie en een gevorderde versie van hetzelfde onderwerp aan. Dit kost meer om te onderhouden, maar levert bevredigender resultaten op voor beide doelgroepen.
Wat niet werkt, is proberen elk publiek te bedienen in één enkele, ongedifferentieerde tekstblok. Wanneer iedereen het publiek is, is niemand dat — en een AI-systeem dat een ongedifferentieerd artikel samenvat, levert net zo goed een ongedifferentieerd, onbehulpzaam antwoord op.
Vergeet de AI-lezer niet
Steeds vaker leest een groot deel van je publiek het artikel nooit direct. Ze stellen een zoekmachine, een AI-assistent of een in-product chatbot een vraag, en dat systeem leest je documentatie, haalt een antwoord op en presenteert het namens jou. Deze "lezer" heeft zijn eigen kenmerken waarvoor het ontwerp waard is:
- Het heeft geen geduld voor verborgen leads — het heeft het antwoord bovenaan het artikel nodig, duidelijk vermeld.
- Het tolereert geen ambiguïteit — vage voornaamwoorden, onuitgesproken aannames en inconsistente terminologie vergroten de kans op een verkeerde of onverstaanbare samenvatting.
- Het kan geen vervolgvraag stellen zoals een mens dat kan — dus volledigheid binnen één sectie is belangrijker, niet minder.
Ontwerpen voor dit publiek botst niet met ontwerpen voor menselijke lezers — de praktijken die een artikel duidelijk en goed gestructureerd maken voor een persoon (een direct antwoord van tevoren, één idee per sectie, consistente termen) zijn dezelfde praktijken die het voor een AI-systeem gemakkelijk maken om correct te vinden en te citeren.
Het Documenteren van je publieksbeslissingen
Publieksdefinities zijn alleen nuttig als ze gedeeld worden. Schrijf op wie je primaire doelgroep is voor elk onderdeel of contenttype in je kennisbank — inclusief de expertise-niveau, de zichtbaarheidscategorie (publiek, privé of gemengd), en of het geoptimaliseerd moet worden voor publieke ontdekbaarheid — en maak die definitie beschikbaar voor iedereen die bijdraagt. Wanneer een nieuwe schrijver begint, moet hij de definitie van het publiek kunnen lezen en meteen begrijpen voor wie hij schrijft.
Bekijk periodiek de definities van het publiek. Naarmate je product groeit en je gebruikersbestand verandert, veranderen ook de mensen — en systemen — die je documentatie lezen.