Real Programmers...
Sinceramente, eu não costumo comentar meus códigos.
Na maioria das vezes, insiro o cabeçalho de copyright de fonte e comento as declarações de classes e funções em estilo Javadoc, o que significa que somente me “protejo” para os casos de o fonte vazar (no caso de fontes fechados), de algum colega programador dizer que eu não comento meus códigos ou reclamar ao rodar o doxygen (um fato que eu nunca precensiei) pra gerar documentação.
Raramente, geralmente quando julgo que nem eu mesmo conseguiria entender o que escrevi uns 2 dias depois, escrevo alguns comentários gerais para tentar iluminar o caminho de algum azarado que tenha de ler o que escrevi (eu mesmo, inclusive).
Deixando as piadinhas de lado, não costumo comentar MESMO! Eu acredito que escrever funções com nomes que expliquem seu funcionamento e objetos inteligíveis é mais do que o suficiente. É claro que eu tento não programar como o Ross nessa tira do Geek Hero Comic (e que acredito que a única maneira de “otimizar” meus códigos seria essa, hehe).
E, pesquisando aqui e acolá, parece-me que muita gente não curte comentários:
While comments are neither inherently good or bad, they are frequently used as a crutch. You should always write your code as if comments didn’t exist. This forces you to write your code in the simplest, plainest, most self-documenting way you can humanly come up with.
E você? Gosta de comentar (código, é claro)? Comente (este post, é claro)!
OFF: Quer comprar um souvenir bacana?
Comentário d+ dificulta a leitura e entendimento do próprio código!
O código tem que ser entendivel!, tem que ser a principal “documentação”. Basta escrever blocos de códigos consisos e bem encapsulados, que é possivel gerar um código com o mínimo, ou nenhuma documentação.
Também adoto a pratica de somente comentar membros e classes (para gerar javadoc), procurando sempre extrair novos métodos quando o mesmo se torna muito extensivo, sem medo de refatorar!(Mas esse já é outro assunto.)
Grande abraço e bom post!
Suzuki e códicos compreensivos? Esse mundo eh loco mesmo.. uhaehasuheasuhuhuaeha
Zuera, to falando random.. acho que vc nao faz mais for’s ultra optimizados em assembly neh =P
Eu uso comments em geral pra me lembrar do que se passava, um comentario em cima de uma funcao ou de um for, não vejo mau..
REAL PROGRAMMERS: http://xkcd.com/378/
Bom.. eu tento esquecer o assembly.. maaaas aeeouahou.
Zueira, acho que consigo viver sem um for ao contrário (de vez em quando)
Mas, pra reiterar: não há porque comentar chamadas de funções straightforward e (a grande maioria dos) for’s. Duvida? Veja o código abaixo…
PS: Acabei de pegar de um repositório que eu utilizo… (CLARO q não é meu!)