Documentazione agile: più parlare, meno scrivere

Perché serve una documentazione in Agile?

I requisiti agili e la documentazione agile condividono un concetto fondamentale: più parlare, meno scrivere. Lo scopo delle User Story è semplicemente registrare informazioni sufficienti per avviare in futuro conversazioni su una funzionalità desiderata. La documentazione agile dovrebbe avere un obiettivo simile: Creare solo la documentazione sufficiente a essere utile, non superflua.

I documenti hanno senso solo se vengono letti

Quando si riflette su quale documentazione sia necessaria per un progetto, bisognerebbe innanzitutto chiedersi quali documenti in questo o in progetti precedenti sono stati utilizzati regolarmente o mai. Promuovete le discussioni che nascono quando il team parla delle varie possibilità di documentazione. In queste discussioni spesso emergono documenti che in passato non sono stati utilizzati per il loro scopo originale o non sono stati utilizzati affatto.

Tutti i documenti che sono stati utilizzati regolarmente dovrebbero continuare a essere usati. Quelli che non sono stati utilizzati probabilmente non dovrebbero più essere usati (a meno che non siano richiesti da leggi o altri regolamenti). Per tutto ciò che sta nel mezzo, il team dovrebbe votare o arrivare in altro modo a una decisione sì/no.

Ma non dovreste fermarvi qui. Per ogni documento che continuerà a essere utilizzato, il team dovrebbe valutare se non esista un’alternativa che preveda più conversazione e meno scrittura.

Esempio di documentazione inutile

Ad esempio, un team con cui lavoravo doveva scrivere un cosiddetto “Database Impact Report” per ogni modifica effettuata. La maggior parte delle modifiche non aveva però alcun impatto sul database, per cui le 20 domande del report di cinque pagine venivano quasi tutte risposte con “nessun impatto”.

Questo documento è stato sostituito da una domanda aggiuntiva nella Deployment Checklist, che recitava: “Sono state considerate le modifiche al database?”

Conclusione

I team agili non sono fondamentalmente contro la documentazione. Cercano però modi per passare dai documenti alle discussioni. Un modo è cercare alternative per almeno alcuni dei documenti esistenti.
E questo vi aiuterà ad avere successo con Agile.

Vuoi capire meglio Agile e imparare come aiutare al meglio il tuo team? Allora partecipa subito a un Training per Scrum Master e diventa Scrum Master certificato in tre giorni con Agile Academy.

Questo contributo proviene da Mike Cohn ed è stato tradotto in italiano.