Gosto dessa visão também, documentar apenas as escolhas das variáveis e funções e não toda a operacionalidade das funções.
Respondendo a "Concordo do POR QUE e nesses casos é realmente..." dentro da publicação Comentários no código boa ou má prática? 🤔
1