Talenkoning · Schrijven

Een instructie schrijven die iemand zelfstandig kan volgen

Bij een instructie telt niet wat jij zelf al weet, maar wat een nieuwe gebruiker nodig heeft. Beschrijf waar die begint, wat die doet en hoe het resultaat eruitziet.

Een instructie schrijven die iemand zelfstandig kan volgen

Beschrijf eerst de beginsituatie

Voor een eenvoudige papieren boekenlegger heeft de lezer papier, een schaar en een potlood nodig. Noem zulke benodigdheden voordat iemand halverwege vastloopt. Geef ook aan welk resultaat je instructie oplevert. Een plaatje kan ondersteunen, maar de tekst moet de noodzakelijke handelingen nog steeds duidelijk benoemen.

Splits handelingen op bruikbare momenten

“Teken een rechthoek, knip die uit en versier de voorkant” bevat drie handelingen. Bij een korte, bekende taak kan dat samen; voor een beginner kunnen afzonderlijke stappen prettiger zijn. Gebruik precieze verwijzingen. “Vouw het papier dubbel” is duidelijker dan “Doe dit zo” wanneer niet vaststaat waar dit naar verwijst.

Test zonder mondelinge reparaties

Laat iemand de instructie uitvoeren en noteer waar vragen ontstaan. Geef niet meteen extra uitleg die alleen in jouw hoofd bestaat. Verwerk die ontbrekende uitleg daarna in de tekst. Een controlepunt, zoals “De twee korte randen liggen nu op elkaar”, helpt de gebruiker zien of een stap gelukt is. Voeg keuzemogelijkheden alleen toe als duidelijk is wanneer welke route nodig is.

Oefen met deze voorbeelden

  1. Waarom zet je de benodigdheden vóór de uitvoerstappen?
  2. Een proeflezer vraagt bij stap drie welk vel bedoeld wordt. Wat verbeter je?
Antwoorden met uitleg
  1. Dan kan de gebruiker alles vooraf klaarleggen en hoeft die de uitvoering niet onverwacht te onderbreken.
  2. Noem het bedoelde vel expliciet of geef de vellen eerder duidelijke namen. Maak de verwijzing in de tekst zelf begrijpelijk.

Ontdek ook