Una volta ero in un progetto in cui un manager non tecnico aveva trascorso metà della squadra a documentare ciò che avevano appena fatto in modo che qualcuno con una comprensione zero della tecnologia sarebbe stato in grado di capire la tecnologia. Personalmente, ho pensato che fosse uno spreco enorme, ma non c'era modo di convalidare che questo fosse o non fosse uno spreco.
C'è un mezzo leggero per convalidare la necessità di documentazione prima di impegnarsi a produrre la documentazione?
Esempio 1: Supponiamo che il team stia utilizzando un software off-the-self senza personalizzazione. Il test potrebbe pubblicare una descrizione del lavoro su base mensile per accedere alla probabilità che un esperto nel software possa essere trovato a un livello di costo accettabile.
Esempio 2: richiama automaticamente variabili, funzioni, ecc. dal codice e due settimane dopo la scrittura del codice, generando domande che valutano automaticamente la conoscenza del proprio codice da parte degli sviluppatori senza accesso al codice. Se lo sviluppatore non è in grado di rispondere alle domande, deve spiegare il codice a un altro sviluppatore e lo sviluppatore decide se deve essere prodotta la documentazione.
Esempio 3: Un altro modo sarebbe quello di prendere la probabilità che il codice venga utilizzato in base all'analisi runtime e fare un riferimento incrociato sia con la volatilità di input / output sia con la probabilità storica di errori / bug riportato da quella sezione di codice e / o richieste basate sul cliente per aggiornare il codice.
Onestamente, non credo che questi siano grandi esempi, ma sono più che altro un tentativo di dare l'essenza generale di quello che sto cercando, e che l'obiettivo è il metodo più utile per le barebone per farlo.