Presentatie over documentatie

< Documentatie
 * Bewegingen: Professionals beweging, Systeemontwikkelaars

Slides

 * Decharge
 * Planning
 * Functionaliteiten

To-do

 * Bespreek het script met één of meerdere FO-ers. Vraag of ze zich kunnen vinden in het verhaal. Vraag ook of je een concreet voorbeeld mag noemen.

Script

 * Documentatie is niet het favoriete onderwerp van veel IT-ers. Het voelt soms een beetje als corvee.
 * Maar ook bij documentatie geldt. Veel handen maken ligt werk.
 * Het is denk ik een good practice voor teams om met elkaar een aantal afspraken te maken over documentatie.
 * Bijvoorbeeld de afspraak dat alle documentatie in Jira wordt gezet.
 * Ik denk dat het ook een good practice is om één persoon in het team een coördinerende en/of faciliterende rol toe te bedelen als het om documentatie gaat.
 * ... heeft gevraagd of ik daar invulling aan wil geven en hij heeft me gevraag om een presentatie te geven over de documentatiestructuur.
 * In de uitnodiging van deze meeting heb ik een link gedeeld met een voorbeeld van een documentatiestructuur.
 * Dit is best een uitgebreide structuur. Ik denk dat het verstandig is, gezien de deadline om met elkaar (en met stakeholders) te bepalen welke documenten het meest zinvol zijn.
 * Mijn tip aan iedereen is om bij het uitvoeren van epics één iemand te vragen om aantekening bij te houden die later omgezet kunnen worden naar documentatie.
 * Bijvoorbeeld ... is verantwoordelijk voor de koppeling met het ... register. Het is dan verstandig dat zij aantekeningen maakt m.b.t. ontwerp-beslissingen die gemaakt zijn.
 * Het is vaak een FO-er die in de regie is m.b.t. de documentatie.