Sto lavorando su una serie di progetti di manutenzione e includo sempre il numero / numero di requisito / codice nei commenti ogni volta che aggiungo o modifichi il codice. In tal modo fornisco la tracciabilità dai requisiti al codice e ritorno. La mia esperienza è che tale sforzo può essere di grande aiuto per la manutenzione successiva, soprattutto se i requisiti cambiano o sono aggiornamenti dovuti a incoerenze iniziali nei requisiti.
Tuttavia, ho visto il codice sorgente di altri progetti che non hanno commenti e posso solo immaginare quale parte del codice sta implementando quale requisito.
Qual è la buona pratica nella tracciabilità di requisiti e commenti?