fev
16
2009
Comentar ou Não Comentar?
Sempre me perguntei qual seria o momento certo de comentar ou não comentar os códigos que implementava. Trabalhando em equipe ou programando sozinho, aparecia em certos momentos a dúvida se aquele trecho de código merecia um comentário ou se a lógica contida nele era suficientemente “entendível”.
Não comentar um código fonte por completo é extremamente prejudicial, porém comentá-lo em excesso também não é nada produtivo ou elegante. Não se deve comentar tudo que você implementa, pois os comentários não são tutoriais ou passo-a-passo do que o seu código faz. Por exemplo: Continue reading
