Mais um bom motivo para não se usar comentários

Você está trabalhando feliz e sorridente naquele projeto de prazo estourado, com aquela API que não funciona, e eis que de repente você encontra a maravilha de código abaixo, devidamente comentada, claro:

t.each(function(){
$(this).bind("click",function(){ //可更换为其他动画形式
t.remove(tbo); // 在此可添加多组选项卡

Que bom, hein? O fonte está comentado, e imagino que deva ter as devidas explicações sobre o que faz cada parte.

Se convenceu agora de que comentários em código, além de dificultarem a leitura e se tornarem um vício, são ruins e devem ser evitados?

Escreva um código que seja esclarecedor por si só, sem sujeira, e seja mais feliz.

Anúncios

2 Responses to Mais um bom motivo para não se usar comentários

  1. fabiogusmaoblog disse:

    Colocando os dois comentários no Google Language Tools temos:

    1) 动画换为outros aceitaram mudar formato
    2) Além disso, muitas组选项卡此可

    Preferia que não tivesse comentários também…..
    Também já vi muito comentário em português do tipo:
    // inteiro usado para armazenar a quantidade de registros
    int count = Int32.Parse(GetField(2));

    Como diria a Copélia: prefiro não comentar!

  2. Pingu disse:

    Parabens, seu site agora esta bloqueado pela matrix, categoria “Social network”. \o/

    RE: Fui sorteado. Google Reader funciona por aí?

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s

%d blogueiros gostam disto: