Een handleiding die mijn agenten ook lezen

Dat hij er is

Onder Documentatie staat hoe het basissysteem in elkaar zit en hoe je ermee werkt, van de eerste dag tot een gewone werkdag. Het zijn ruim veertig artikelen, en sinds 5 oktober ook een lijst met de accounts en sleutels die je voor de installatie aanmaakt. Je kunt erin zoeken.

Dat klinkt als een kleinigheid, maar dit systeem verandert elke week. Een handleiding houdt dat alleen bij als iemand hem bijhoudt. Bij mij doet een van mijn agenten dat, en ik lees mee. Voor hij online ging, zette ik er in twee rondes 283 opmerkingen bij. Sinds 2 oktober ging hij elf keer opnieuw live.

Mens en machine lezen hetzelfde

Wat er in de handleiding staat, is hoe het systeem werkt. Hij gebruikt dezelfde begrippen en dezelfde routes als de code en de regels waarop mijn agenten draaien. Wordt er iets aan het systeem veranderd, dan past mijn agent de handleiding aan, vaak dezelfde dag. Op 4 oktober werd om 9.25 uur een onderdeel van het systeem aangepast, en vijf minuten later stond dat in de handleiding.

En dan de wisselwerking

Het belangrijkste is dat iedereen naar hetzelfde kijkt. Een agent kan mij naar het artikel sturen dat over mijn vraag gaat, en ik kan hem er net zo goed naartoe sturen. Neem ik een omweg waar de handleiding een route voor heeft, dan wijst hij mij op dat artikel.

Wat het oplevert

1Eén keer uitleggen

Wijst een agent naar een artikel, dan lees ik precies wat hij bedoelt, en omgekeerd. Wat al op een pagina staat, leg ik maar één keer uit.

2Fouten komen eerder boven

Wijkt een agent bewust af van de handleiding, dan moet hij dat zeggen. Dan klopt het systeem niet of de handleiding niet, en dat zie ik voordat het misgaat.

3Elke nieuwe deelnemer kan zich voorbereiden

Elke nieuwe deelnemer krijgt de handleiding. Hij ziet hoe het werkt en kan zich vast voorbereiden. Ben je nieuwsgierig, dan kun je dat ook. Kijk in de documentatie hoe het werkt, en of het iets voor je is.