Come ingegnere informatico di 20 anni in piedi, che lavora principalmente su argomenti relativi alla sicurezza (SF-PD), dovrei dire che il tuo capo potrebbe non essere la persona che vuoi essere il tuo esempio. La mancanza di commenti è un segno di un programmatore amatoriale autodidatta che non ha mai imparato come fare correttamente il lavoro, o un ingegnere inesperto. O forse un ingegnere che semplicemente non ha il tempo - le scadenze e le convenienze possono fare cose orribili al tuo codice! ;) È sicuramente un anti-pattern per ogni ingegnere del software competente però.
Il tuo capo potrebbe essere un ottimo programmatore, ma sembra che non sia un bravo ingegnere del software. Un ingegnere usa l'esperienza collettiva di gruppo per evitare le insidie che altre persone sono già state scoperte. Un commento efficace fa parte dell'esperienza collettiva di gruppo per il software, nello stesso modo in cui l'analisi dello stress fa parte dell'esperienza collettiva di gruppo per l'ingegneria meccanica. Ciò che conta è che i commenti efficaci sono più fluidi, ed è sicuramente qualcosa che ottieni dall'esperienza.
La cosa più semplice è che i commenti non dovrebbero dire cosa fa una riga di codice. Ci sono momenti in cui i commenti per dire cosa sia una funzione sono superflui (specialmente in C #). I commenti eccessivi possono essere altrettanto inefficaci (e un puntatore alla mancanza di esperienza) perché non riesci a trovare le cose importanti nelle scorie. Come novizio, potresti ancora lavorare per capire il "cosa" del codice, e per questo hai solo bisogno di leggere e capire cosa ha fatto.
La cosa importante per i commenti è che dicono PERCHÉ una linea di codice o una funzione fa quello che fa, dove questo potrebbe non essere ovvio. Devi configurare il modulo X prima del modulo Y? È importante controllare un codice di ritorno per vedere se un file era già aperto o ignoriamo consapevolmente il codice di ritorno perché questo è stato controllato da qualche altra parte? Il "perché" del codice sarà rilevante per tutti, indipendentemente dall'esperienza - e sarà rilevante anche per lui tra 6 mesi, quando si dimenticherà della buona ragione per fare qualcosa in un modo particolare. Commentare non è solo per le altre persone, è per aiutarti anche in futuro.
Se vuoi evitare di annoiare il tuo capo, fai domande intelligenti. Concentrati sul chiedere il "perché" e cerca di capire il "cosa" (a meno che non sia veramente oscuro). A nessun buon capo verrà in mente di fare domande se non sono il tipo di cose che potresti aver trovato da R-ing TFM. E a nessun buon ingegnere verrà in mente di essere invitato a fare qualcosa che renderà la vita di un altro ingegnere molto più semplice, con un piccolo costo per loro. (Basta non chiedergli di recuperare i commenti sull'intera base di codice!;)