“Klik gewoon op instellingen” klinkt eenvoudig als je precies weet waar die knop staat. Voor een ander kan het scherm er anders uitzien, kan het woord onbekend zijn of kan de angst om iets fout te doen de volgende stap blokkeren. Goede digitale uitleg neemt die onzekerheid serieus zonder de lezer klein te maken.
Een handleiding is geen verslag van wat jij als maker weet. Het is een route voor iemand die een doel wil bereiken. Die route moet herkenbare tussenpunten, duidelijke keuzes en een veilige weg terug hebben. Met een paar vaste schrijf- en testprincipes kun je uitleg maken die veel meer mensen zelfstandig helpt.
Begin met één concreet resultaat
Schrijf bovenaan wat de lezer na afloop kan. “Je factuur als pdf downloaden” is duidelijker dan “Uitleg over het klantportaal”. Benoem vooraf wat nodig is, zoals een inlogcode, telefoon of klantnummer. Vermeld ook hoeveel tijd de handeling ongeveer kost en of een stap niet ongedaan kan worden gemaakt.
Ken het echte beginpunt
Experts beginnen vaak drie stappen te laat. Ze nemen aan dat de lezer al is ingelogd, de juiste app heeft en weet welk menu bedoeld wordt. Kijk daarom mee met iemand die de taak niet dagelijks uitvoert. Vraag waar die persoon start en welke woorden op het scherm staan. Begin je uitleg op een plek die de lezer zelfstandig kan herkennen.
Maak aparte routes als schermen werkelijk verschillen. Een korte aanwijzing voor Android en iPhone is beter dan één zin vol uitzonderingen. Vermeld versies alleen wanneer dat nodig is; interfaces veranderen. Een beschrijving van positie én label, zoals “kies onderaan Profiel”, blijft vaak langer bruikbaar dan alleen “tik rechts”.
Gebruik woorden van het scherm
Noem knoppen en menu’s precies zoals ze zichtbaar zijn. Zet het label vet, maar schrijf de rest rustig. Vermijd synoniemen tijdens dezelfde route. Als de knop Opslaan heet, noem hem later niet “bevestigen”. Leg een onbekend begrip kort uit op het moment dat het nodig is.
- Schrijf één handeling per genummerde stap.
- Begin met een actief werkwoord: open, kies, vul in of controleer.
- Vertel wat de lezer na de stap op het scherm ziet.
- Waarschuw vóór een onomkeerbare handeling, niet erna.
Maak iedere stap controleerbaar
Een lezer wil onderweg weten of het goed gaat. Sluit belangrijke stappen daarom af met een herkenbaar resultaat: “Je ziet nu een groene melding met de tekst Betaling ontvangen.” Als dat resultaat niet verschijnt, geef dan één logische herstelactie. Zo hoeft iemand niet vol onzekerheid door te gaan.
Gebruik beelden alleen waar ze richting geven
Een schermafbeelding is nuttig als de plaats van een knop moeilijk te beschrijven is. Snijd hem bij tot het relevante deel, maar laat genoeg omgeving staan voor herkenning. Markeer hooguit één element. Vervang oude schermafbeeldingen zodra de interface verandert en zet nooit echte persoonsgegevens, meldingen of toegangscodes in beeld.
Beeld kan tekst ondersteunen, maar mag niet de enige drager van informatie zijn. Mensen die een schermlezer gebruiken of op een klein scherm inzoomen, moeten de route ook zonder afbeelding kunnen volgen. Geef elk informatief beeld daarom een beschrijvende alternatieve tekst. Decoratieve beelden hebben geen plaats in een korte werkinstructie.
Schrijf foutmeldingen mee
Noteer de meest voorkomende foutmelding letterlijk en leg in gewone taal uit wat die betekent. Geef daarna een concrete actie. “Sessie verlopen” wordt bijvoorbeeld: “Je was te lang niet actief. Log opnieuw in; je eerder opgeslagen gegevens blijven bewaard.” Beloof dat laatste alleen als je het hebt getest.
Schrijf voor rust en toegankelijkheid
Gebruik korte zinnen, voldoende witruimte en duidelijke tussenkoppen. Dat helpt niet alleen mensen met weinig digitale ervaring. Ook een geoefende gebruiker die haast heeft, op een telefoon leest of moe is, vindt sneller de juiste stap. Vermijd grapjes in waarschuwingen en beeldspraak bij kritieke handelingen. Duidelijkheid is daar vriendelijker dan originaliteit.
Controleer kleurcontrast en maak links beschrijvend. “Download de handleiding als pdf” vertelt meer dan “klik hier”. Zorg dat uitleg met een toetsenbord te bedienen is en dat tekst vergroot kan worden zonder dat knoppen verdwijnen. Ondertiteling en een tekstversie maken video-uitleg bruikbaarder in stille ruimtes en voor mensen die geluid niet goed horen.
Laat de toon volwassen en uitnodigend zijn
Schrijf rechtstreeks in de jij-vorm en vermijd opmerkingen als “heel simpel” of “uiteraard”. Wat voor de maker vanzelf spreekt, kan voor de lezer nieuw zijn. Benoem keuzes zonder oordeel. Zeg bijvoorbeeld: “Heb je nog geen account? Maak er eerst één aan” in plaats van “Je had natuurlijk al een account moeten hebben.”
Test met echte gebruikers
Laat drie mensen de taak uitvoeren zonder mondelinge hulp. Kies niet alleen collega’s die het systeem kennen. Vraag hen hardop te zeggen wat ze verwachten en waar ze twijfelen. Geef geen aanwijzing zodra iemand vastloopt; noteer de plek. Iedere mondelinge uitleg die je toch wilt geven, is informatie die waarschijnlijk in de handleiding ontbreekt.
Onderhoud hoort bij publiceren
Zet op de handleiding een eigenaar en controledatum. Geef lezers een eenvoudige manier om een fout te melden. Verzamel vragen die bij de helpdesk terugkomen en verwerk patronen in de uitleg. Voeg niet voor elke losse vraag een extra alinea toe; verbeter liever de stap die de verwarring veroorzaakt.
- Omschrijf één zichtbaar eindresultaat.
- Begin waar een nieuwe gebruiker werkelijk begint.
- Gebruik de exacte labels van knoppen en menu’s.
- Geef na belangrijke stappen een controlepunt.
- Beschrijf fouten en een veilige herstelactie.
- Test zonder mondelinge hulp.
- Plan een vaste inhoudscontrole.
Goede digitale uitleg geeft de lezer niet alleen een juist antwoord, maar ook vertrouwen. Je merkt het wanneer minder mensen afhaken, vragen specifieker worden en gebruikers een volgende keer zelfstandig verder kunnen. Dat is geen versimpeling van de inhoud. Het is zorgvuldig ontwerp met woorden.
