Man o man, wat een ellende, documenteren, ms-word, powerpoint, excel, sharepoint. En nog steeds begrijpt niemand wat er gedaan is. Nieuwe medewerker aan boord? Wie gaat hem vertellen waarom het is zoals het nu is? Het standaard probleem in omgevingen waar software wordt gebouwd. Gelukkig heeft de Agile-beweging al veel opgelost. Maar nog steeds is daar die worsteling met 'wat documenteren we wel en wat niet?'
Bij klant X hebben we daarom 80% van de documentatie geschrapt en zijn we overgestapt op filmpjes.
We hebben het jaar opgeknipt in blokken van twee weken en aan het einde van de week mogen de acteurs vertellen wat ze twee weken lang gedaan hebben. De flmpjes hebben we op een intranet-you-tube-look-a-like-kanaal gezet en geordend op bloknummer. In de documentstore staan per bloknummer 1 document, zijnde een releasenote waarin kort is beschreven wat er dat blok allemaal gebouwd is. Wel hebben we een software-quality tool die automatisch de kwaliteit van de code laat zien zodat we kunnen sturen op de testbaarheid en structuur van de code.
En het team? Dat is waar de meeste aandacht naar uit gaat. Een team dat bereid is te delen wat ze hebben gedaan en geleerd. Een team dat zo stabiel mogelijk is.
Wellicht is dat het antwoord op de zoektocht van de schone schijn van documentatie.
Kijk hier wat Nicole de Swart hier over zegt #Reaco
Geen opmerkingen:
Een reactie posten