Navegando na web, vi este site que fala coisas muito interessantes sobre programadores.
Uma coisa que chamou muito a minha atenção foi: Real Programmers don't need comments -- the code is obvious.
Ora, quando tenho a oportunidade de ver o código de algum sistema, me deparo com o seguinte:
// A string dia recebe o valor "segunda"
String dia = "segunda";
Esse tipo de comentário realmente é desnecessário, contudo devemos pelo menos comentar uma rotina complexa de cento e tantas linhas explicando alguns passos, pois devemos pensar no próximo que vai dar manutenção nesse código no futuro.
Assinar:
Postar comentários (Atom)
4 comentários:
"Macho véi", cade o tutorial de JSF?? hehehe
Um grande abraço meu amigo!!!
Eu acredito que em certos pontos de uma aplicação ou regra de negócio não há necessidades de comentários, porém noutros casos é essencial algum tipo de comentário, principalmente quando a coisa parece complicada até mesmo para que escreveu :)
Quando se trata de regras de negócios -quando bem modelado o domínio-, ou seja, objetos colaborando entre si para chegarem a um fim, não haverá grandes necessidades para comentários, pois o domínio da aplicação está bem modelado entre objetos, fica fácil ententer a interação entre eles.. mas nada impede de colocar algum tipo de comentário.
Enfim, o importante é nunca exagerar em comentários, muitas vezes o código passa por um refactoring mas os comentários não. Já cansei de ver isso e perder horas revisando casos de uso.
Abraços.
Eu concordo com o Rafael Ponte, comentário é importante, mas sem exagero :)
Comentários são realmente desnecessários.
Se alguém vai alterar uma rotina, e precisa ler um comentário para poder compreendê-la, é melhor nem tocar no código: um médico não abre seu paciente sem antes saber onde fica o fígado. ;)
Abraço!
Postar um comentário