A falsa impressão de um bom código

Desde quando comecei a trabalhar com desenvolvimento de software, ouvia sempre uma frase que é muito repetida até hoje. A conhecida frase diz que: "Código bom é código comentado".

Em conversas com outros desenvolvedores, alguns reclamavam porque que se viam obrigados a comentarem seus códigos para poderem passar pelas auditorias internas. Hoje vejo isso como um absurdo (para não dizer outra coisa).

Muitos comentários podem mesmo ser parâmetro para definir um bom código? Eu, particularmente, sou defensor de um código não comentado, ou com o mínimo de comentários possível. Muitos devem estar se perguntando agora: como assim, código não comentado? Esse cara está ficando louco? Mas não falem mal de mim ainda, vou explicar o meu ponto de vista.

Um código comentado quase sempre é sinal de código ruim. Se você sentiu a necessidade de comentar seu código é porque até você está percebendo que o mesmo não está expressivo e que todas as suas linhas não conseguem refletir o seu verdadeiro objetivo.

Acredito que certos códigos realmente são difíceis de serem expressivos, mesmo sendo refatorados. Podemos citar, por exemplo, o uso de bibliotecas de terceiros que às vezes não apresentam o funcionamento esperado e, nesses casos, somos obrigados a comentar determinados trechos, para facilitar a vida dos outros desenvolvedores que futuramente irão dar manutenção no código.

Um outro caso que também pode caber comentários é quando estamos desenvolvendo uma biblioteca para ser utilizada externamente. Nessa situação, os comentários "podem" auxiliar o uso da biblioteca. Mas ainda permaneço com o pensamento de que podemos sempre buscar alternativas para evitar os comentários.

Um código muito comentado pode trazer outro problema: a manutenção do próprio comentário. Sabemos da dificuldade que é em muitos casos dar manutenção em um código de produção, agora some a isso o esforço de atualização também do comentário.

Seu código deve ser expressivo

Para tentar demonstrar um código expressivo, imaginei um exemplo em que seja necessário implementar um método que aplique descontos nas mensalidades dos alunos do 5° período ou superior, e que tenham o coeficiente de rendimento maior ou igual a 7.

Código com necessidade de comentário



Abaixo apresento o método "AplicarDescontosMensalidades" refatorado, com um código mais expressivo:

Código refatorado sem a necessidade de comentário









fonte

A bem cara tudo oque eu sou hoje "Bem não sou grande coisa ^^" mas tudo oque eu sei de PHP HTML MYSQL e etc São por caisas dos comentarios eu até hoje o unico tutoriail que eu vi foi de como conectar com o mysql o resto aprendi na base de Olhar os porjetos dos outros Mas muitos não erão comentados e ficava dificil de eu entender mas resumindo Tudo que eu sei Hoje é por causa dos comentarios dos codigos.
Antes eu tinha medo de mexer em php não sabia nem uque era um echo nem variavel descobri por acaso quando baixei um arquivo em php pensando que era uma musica, nele tinha uns cometarios de tipo "Se mudar isso acontece isso" e foi por causa disso que eu me interesei então Comentando ajuda pelo menos 1 pessoa aquele que num sabe nada e quer aprender, bem é isso ^^
me empolguei um pouquim na hora de escrever.