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.