Escrevendo o post sobre comentários no Ruby, me veio à mente um assunto bastante recorrente no desenvolvimento de software: o uso correto dos comentários.

Basicamente, existem 3 abordagens relativas a este assunto, e ao escrever sobre cada uma delas, eu percebi que se trata de um tópico um pouco mais extenso do que eu imaginava. Sendo assim, decidi dividir o que originalmente seria um post bem longo, em uma série de 3 posts mais focados, sendo um sobre cada abordagem.

O 1º post, Comentários são para fracos!, analisa a abordagem mais cômoda: não escrever comentário algum. Avalanche de comentários é o 2º post da série, e fala sobre a prática de entupir o código fonte de comentários. Por fim, temos o post Código autodocumentado, que é sobre o que eu acredito ser a melhor forma de atacar o problema: escrevendo código autodocumentado.

Espero que gostem desta pequena série de posts relacionados.