Credo con qualsiasi documentazione che l'approccio agile sia buono. Ora, ci sono alcune idee sbagliate là fuori che agile significa "nessuna documentazione o analisi", ma non è questo il caso. Le cose che ho letto sull'agile dicono "usa ciò che funziona". Prendo questo per dire che il documento dovrebbe essere di lunghezza e dettaglio commisurato al compito.
I modelli possono essere utili come elenco di controllo, ma non richiederei che ogni sezione venga compilata per modifiche a rischio ridotto o a rischio ridotto. Per un cambio di una riga, forse non hai affatto bisogno di un documento. Non ho mai utilizzato un modello per un documento di analisi dell'impatto, ma mi occupo regolarmente dei requisiti aziendali o delle specifiche tecniche. Un modello può essere troppo restrittivo; una buona guida è invece quella di considerare chi sarà il pubblico. Se è per i manager che non sono tecnici, concentrati sulla giustificazione aziendale del cambiamento. Se è per le persone tecniche, fornisci un po 'di retroscena in modo che una nuova persona nel team non vada persa e dia loro abbastanza per andare avanti se devono sostenere il cambiamento. Inoltre, se vuoi qualcosa di ancora più attrito e leggero, non usare affatto un documento, mettilo su un wiki.
Informazioni da includere:
- Breve descrizione del problema
- Spiegare o mostrare un esempio di come il difetto sta causando il fallimento e / o l'inefficienza
- Includi stima della complessità
- Includi stima del costo e del tempo per la correzione
Questo è un minimo accettabile. L'altro post ha messo in evidenza alcune cose CMMi piuttosto pesanti da IBM; è fantastico se hai tempo e risorse per farlo (e quando stai costruendo sistemi per la NASA in cui è in gioco la vita umana, allora le persone dovrebbero essere seri in proposito) ma per le piccole squadre probabilmente non hai bisogno di essere così pesanti . Fai attenzione alla stima, come sempre. I manager sono inclini ad assumere che una stima sia effettiva.
Si noti che ci sono pericoli nell'approccio agile. Alcuni sviluppatori pensano che significhi "nessun documento necessario, basta iniziare a distruggere" (che potrebbe andare bene in alcune situazioni). Inoltre, altri prenderanno la latitudine data l'attività e semplicemente scrivono documenti davvero schifosi che non aiutano veramente (non necessariamente OK nella maggior parte delle situazioni). Parte del problema è che scrivere bene richiede un po 'di sforzo, abilità e tempo; la maggior parte di noi ha almeno due di queste cose;)
Sono sempre stato grande sulla documentazione perché ti dimostra almeno di aver riflettuto abbastanza per qualificarti come se avessi un piano. Ma nella mia vecchiaia ho anche capito che troppa documentazione può diventare di per sé una seccatura di manutenzione, e che non ci sono abbastanza persone che si preoccupano abbastanza per mantenere aggiornata la documentazione.