Een teamhandboek moet iemand helpen een taak uit te voeren, niet alleen bewijzen dat er een document bestaat. Begin met één terugkerende procedure en een lezer die jullie interne vocabulaire nog niet kent.
Kies een onschuldig voorbeeld: het voorbereiden van de goedgekeurde bestanden voor een workshopsessie. Het doel is een duidelijk herkenbaar pakket, geen beschrijving van alles wat het bedrijf doet.
Bepaal de taak van de pagina
Schrijf op wie de pagina gebruikt, wat diegene nodig heeft voordat hij begint en wat het zichtbare resultaat is. Houd één procedure per pagina aan, tenzij nauw verbonden handelingen samen moeten worden uitgelegd.
Gebruik deze structuur:
Doel: de goedgekeurde workshopmaterialen voorbereiden. Voordat je begint: toegang tot de actieve map en de sessie-identificatie. Handelingen: de bestanden zoeken, controleren, samenstellen en overdragen. Afronding: de ontvanger kan het juiste pakket herkennen. Eigenaar: de persoon die wijzigingen in deze procedure goedkeurt.
Leg de verborgen kennis uit
Let op termen die alleen ervaren collega's begrijpen. Noem de werkelijke locatie of beslisregel in plaats van te schrijven: „gebruik het gebruikelijke bestand.” Als een stap toestemming vereist, leg dan uit wie die kan geven.
Koppel screenshots aan de softwareversie en de controledatum. Een afbeelding helpt wanneer die iets laat zien wat de lezer moet herkennen; ze vervangt geen beschrijving van de handeling.
Maak updates controleerbaar
Geef de pagina een eigenaar, een goedkeuringsstatus en een aanleiding voor controle. Een procedure moet mogelijk worden gecontroleerd wanneer een tool verandert of wanneer het bedrijf zijn proces wijzigt. Leg vast wat de nieuwe versie vervangt.
Als de pagina onopgeloste vragen bevat, maak die dan zichtbaar. Laat een concept niet goedgekeurd lijken alleen om het handboek overzichtelijk te houden.
Probeer een oefening met een nieuwkomer
Geef de pagina aan iemand die de taak niet kent en laat diegene met veilige voorbeeldbestanden werken. Begeleid diegene niet door elke verborgen stap. Noteer waar diegene aarzelt, een vraag stelt of het verkeerde bestand kiest.
Gebruik die observaties om de instructies te verbeteren en herhaal het betreffende deel. Een handboek wordt nuttig door dit controleren en onderhouden. Het hoeft niet te beweren dat alle bedrijfskennis automatisch door AI wordt doorzocht of actueel gehouden.
Mika is een redactionele schrijversnaam die wordt gebruikt door de redactie van KENJTEC in Hamburg. Dit artikel stelt een werkwijze voor; het rapporteert geen afgeronde test.
