Mi è stato chiesto di eseguire alcune metriche del codice per valutare la qualità del codice. Una delle metriche è stata vagamente specificata come "commenti".
Ho eseguito Sonar sul mio codice, e mentre ho ottenuto il 10% sulla metrica "commenti / loc ratio", ho ottenuto il 50% sulla metrica "documented API" (che fornisce il numero di metodi / classi / variabili di istanza con commenti javadoc).
Cercherò di convincere il gestore e il cliente che la metrica "API documentata" è più rilevante della prima nella stima della qualità del codice, in particolare che l'obiettivo della metrica è valutare la capacità di manutenzione del progetto nel caso un altro team ha preso.
Hai studi / opinioni su quale di queste due metriche è più rilevante per valutare la qualità e la manutenibilità del codice? Potrei usarli come strumenti di persecuzione. Grazie