Porque comentar código não é legal

Opa, e aí moçada! Tudo certinho?
No post de hoje vou falar sobre um assunto que incomoda muita gente. E não é sobre elefantes. Na verdade, nunca entendi porque eles incomodam tanto. Bom, deixa pra lá e vamos ao que interessa.
Às vezes, quando analisamos programas antigos, podemos ver muitos trechos de códigos comentados. A ideia é substituir por novas linhas para melhorar o código ou alterar sua funcionalidade, como o exemplo abaixo:

Quem nunca teve que fazer isso? Se você perguntar o porquê, eis algumas possíveis respostas:
– Para melhorar a manutenção do código. Fazendo isso os outros programadores podem acompanhar as mudanças no código.
– É mais fácil de reverter para versões anteriores.
– Se você tiver seu cérebro devorado por algum zumbi, outro programador poderá acompanhar o que você estava fazendo.

Agora vamos deixar o bla bla bla de lado. Eu considero tudo isso um péssimo hábito. Primeiro, porque afeta a legibilidade do código, deixando mais complicado para fazer qualquer manutenção. Segundo, porque você simplesmente não precisa disso, é só usar o gerenciamento de versão.
O código fica cheio de comentários inúteis, o que sobrecarrega a leitura e análise do código. Como alguém disse aqui nesse fórum: “às vezes é como cavar um túmulo para encontrar o código que está sendo utilizado”. É, bem por aí. :/

O que fazer então?

Existe um gerenciamento de versão para a maioria dos objetos. Assim você pode comparar com a versão que está sendo utilizada em produção e também reverter para uma versão anterior ou ainda armazenar uma versão intermediária. Então, o que eu sugiro é gerar uma versão antes de começar a alterar o programa. É só ir em Utilitários -> Versões -> Criar versão.

Comentar um código só faz sentido quando você não tem certeza se as alterações que você está fazendo estão corretas. Esses comentários podem te ajudar quando for testar o programa e entender porque as modificações não estão funcionando como esperado. Mas quando o programa for totalmente testado e está pronto para subir para produção, vale a pena gastar alguns minutos para deixar o código limpo. Também seria bom apagar variáveis ou rotinas que não estão mais sendo usadas.

“Então você acha que não deve ter nenhum comentário sobre as mudanças feitas no código?”
Não é bem assim, acho que um breve comentário no cabeçalho sobre as mudanças implementadas pode ajudar outros programadores a entender a funcionalidade atual do programa. Comentários úteis são sempre bem-vindos!

E qual sua opnião sobre o assunto? Comenta o código? Apaga tudo? Sai correndo? Deixa sua opnião ae! 🙂
Valeu!