Código bem comentado

Publicado em 02/02/2012 09:30 232 Comentários
 
c:\>Share on Facebook300Tweet about this on TwitterShare on Google+103Share on Tumblr0Pin on Pinterest1Email this to someoneShare on LinkedIn8

Quer comprar essa camiseta?

/* História real enviada por Andre Luiz */
Programador: Cara, esse código que você fez não tem um comentário… Você tem que comentar para ficar mais fácil de entender os mistérios que passam pela sua cabeça…
Alonso: Tá… Vou comentar, depois te passo…
Depois…
Alonso: Pronto, tudo comentado!
No computador:

/* Agora, vou dar um printf */
printf (...);

Programador: FACEPALM!

Tag: , , ,

Categorizados em:

  • louis

    Mais comum do que possa parecer…
    uma vez peguei um código que comentaram o chinês feito sobre o algoritmo…

     
  • Alexandre Di Salvo

    Já vi muito essa cena hahaah

     
  • http://felipearon.net Felipe Aron

    Melhor mesmo é quando encontra algo do tipo (verídico):
    “.. não mexa uma linha sequer, se não vai dar pau!”

     
    • Fcoromoto

      boa!!! kkkkkkk

       
    • http://www.rpgvale.com.br/ Bitetti

      mais legal é encontrar isso no fonte do UltraVNC!!!

       
    • http://dev-null.net/ /dev/null

      aqui na empresa no index.php do sistema tem:

      /* favor não descomentar
      ….B.U.G.S…..
      */

       
      • Robson Vieir

        todo é para os fracos.

         
    • Renata

      Já vi:
      /* não mexa aqui, você não vai entender mesmo */

       
      • DeNovo

        Hehehehe … eu já deixei comentários assim em mais de um código. Em um PL/SQL ficou:

        /* Se parecer idiota, você não entendeu. Saia sem salvar e peça ajuda! */
        IF
        THEN
        NULL;
        ELSE

        END IF;

         
    • Eduardo

      Já vi

      /*a consulta abaixo não funciona, em um momento futuro será implementada*/

       
      • http://facebook.com/arcanjoamorim arcanjoamorim

        huashuashusahuauhasuhasuh já fiz isso x3

         
    • Anon

      // nao mexa aqui! eu nao sei como, mas esta funcionando

       
      • Max

        Kkkkk esse eu já vi, muito foda kk…

         
  • Dah Espindola

    Por essa, o Alonso merece o troféu Capivara Humana Gold Plus. Tomara que ele não comente os comentários também.

     
  • http://felipearon.net Felipe Aron

    Outra melhor ainda é (verídico):

    if (….) then
    begin
    /* nada a fazer… */
    end
    else
    begin
    … código….
    end

     
    • http://csharpstarteredition.blogspot.com/ Willian

      Lógica by Alonso, com direito a comentário /* … */ numa linha só… rsrs

       
      • /dev/random

        Opa, comentario /* … */ é padrão ANSI viu 😛

         
        • Bardes

          os comentários com “/**/” são (originalmente) o único método de se comentar em C. Em C++ ambos modos (o “//” e o anterior) são aceitos, sendo as barras mais recomendadas para comentários pequenos ou para comentar linhas de código, já que não causam problemas mesmo quando se comenta uma linha que já tinha um comentário antes…

           
    • Heitor Silva

      Já peguei isso várias vezes…

      fora quando eu pegava os //todo dentro de IF
      Oo

       
    • Linconl

      Padrão “Else forever”

       
    • Azarias

      Olha da última vez que vi isso, retirei do código e a porra de pau, voltei o maldito e funcionou de boas… vai entender.

      Isso sem contar as variáveis que mudam de valor do nada e assim que vc comenta alguma coisa o erro some…

       
      • Mago

        Voce nao tá falando sério….

         
        • Eduardo

          no meu trabalho final de uma materia da faculdade,o sistema nao carregava,ai eu e minha dupla tivemos a brilhante ideia de por um alert…funcionou

           
      • Phill

        Já passei um problema parecido… Depois de muito tempo tentando encontrar um erro no programa, resolvi colocar um print pra ver onde o programa estava, foi o seguinte print:
        printf(“Puta que pariu”);

        Misteriosamente o programa funcionou nessa hora… Depois dessa eu tive que rir.

        Mas por fim achei o erro e corrigi o código

         
        • Anonimo

          Vc estava usando o dev-cpp ?? Pq ele realmente tem muito bug.

          Varias vezes eu trocava:

          int i;
          int j;

          por

          int j;
          int i;

          E o codigo começava a funcionar. Inspecionando o assembly do programa gerado, era assustador as bizarrices do codigo gerado por ele. Não sei q versão do gcc q eles compilaram lah, mas eh muuuuito tosca.

           
          • @wbarbosa_

            Isso tá com cara de que em algum momento o programa está gravando algo onde não deveria e ao se trocar as vars de posição trocou-se os endereços delas e a gravação em local errado não surte mais o efeito colateral visto anteriormente…

            Já alonsei muito assim.

             
    • Davi Cardoso

      Já vi um amigo precisar fazer um comentário exatamente igual a esse. Meus colegas e eu rimos muito enquanto questionávamos o fato de que o programa não funcionava direito caso o IF inútil fosse removido. Não tive tempo de avaliar a lógica aplicada ao programa, então, até hoje aquilo é um mistério pra mim! #CiênciasOcultasDaComputação

       
  • http://twitter.com/AbrahamAlves Abraão Alves

    (Comentário no sourceCode é a confirmação de um codigo não expressivo.)

    Por essa e por outras:
    Sem comentário.

     
    • Fernando

      Se eu pudesse dava 1000 up votes! mas te prepara que vc vai levar 1000 para baixo, da galera que acha que comentário substitui código bem escrito.

       
      • http://www.aprenderprogramar.com.br Renato Louro (@rslouro)

        Acho que qualquer programador maduro sabe que comentário não substitui um código bem escrito. Assim como quero acreditar que qualquer programador maduro sabe que nada substitui um código bem documentado já nos próprios comentários.

        Hipóteses assumidas por uma função/classe, suas restrições, como utilizar uma função são exemplos de comentários que deviam estar presentes num código fonte.

        É claro que alguns, por inexperiência acham que um código bem documentado é parafrasear o mesmo em portugol.

         
        • http://www.awtisolucoes.com.br Alexandre Willian

          O comentário do Renato está muito correto em enfatizar a importancia dos comentários bem estruturados, principalmente em lembrar que comentários fazem parte da documentação do projeto, que pode ser requisitado pelo cliente em alguns projetos, como ja conteceu em um projeto que trabalhei, e consequentemente isso é pago pelo cliente, então um bom comentário é tao necessário quanto um bom código.

           
      • Aramati_

        Alguem me disse uma vez que a documentação começa pela variáveis autoexplicativas e código legível.

        Nesse ponto de vista então pode-se dizer que -> Um codigo muito claro e legível já pode ser considerado um código comentado.

         
        • Cristiano Steffens

          Recomendo Clean Code do Uncle Bob, um dos melhores livros sobre qualidade de software que já lí até hoje.
          “A qualidade é o resultado de 1 milhão de atos altruístas de importar-se.”

           
      • http://www.twitter.com/jeferod83 Jeferson Rodrigues

        Depende, as vezes um comentário bom para um código porco faz o programador reduzir o calhamaço de lixo em duas linhas de fácil compreensão.

         
    • Raphael

      Quero ver vc dando manutenção em um código de mais de 1000 linhas sem comentário nenhum….

       
      • Fernando

        1000 linhas? se vc tem um arquivo desse tamanho, meu amigo, não são comentários que vão te ajudar.

         
        • louis

          já peguei uma classe de 52000 linhas pra dar suporte.
          Haja coração amigos!

           
          • blah

            52k, vish, o maior que eu peguei foi 12k e o meu editor quase nao abria ele, imagina esse então.

             
          • http://dev-null.net/ /dev/null

            por isso é que eu defendo um log no cabeçalho de todos os arquivos indicando quem foram os últimos a editar… na dúvida, liga pra ele 😉

             
          • louis

            pra isso existe versionamento

             
          • Henrique Pacheco

            Era mais ou menos assim?

            Class TudoAconteceAqui { …

             
          • Eduardo

            que classe era essa?Sistema.java? Programa.php?

             
        • http://asfernandes.blogspot.com Adriano dos Santos Fernandes

          Ei, o mundo real não é como o mundo da fantasia das faculdades.

           
          • Azarias

            no mundo real a gambiarra impera e não é só na programação não.

             
          • Fernando

            Sim, na faculdade vc pode fazer o seu trabalho criando tudo num grande arquivo ou um método de 600 linhas que ninguém vai se importar. Talvez seu professor de OO te chame a atenção.

            Fazer isso é porquice. É não se preocupar com o que faz e usar o tempo e a pressão como desculpas para a sua limitação. Onde trabalho, todas as classes grandes são refatoradas. Se alguém tem dificuldade de entender a importância disso, vai fazer pair programming com outra pessoa. Mas normalmente, pessoas assim nem são contratadas.

             
          • Werner

            @Fernando, por mais que eu queira concordar com vc, infelizmente (MESMO) sou obrigado a dizer que na vida real, não só essas pessoas são contratadas aos montes, como elas muitas vezes acabam virando o ‘chefe’. Eu já vi isso acontecer mais vezes do q gostaria de ter visto.

            Ou então eu andei trabalhando nas empresas erradas (o que tbm é verdade de certa forma).

            Quanto à forma de se trabalhar, eu concordo contigo em 100%.

             
        • Victor Hugo

          Nem todos os objetos só debitam ou creditam na conta corrente. Tem objetos que têm vários comportamentos e isso é natural. A OOP serve para modelar o comportamento de um processo/sistema mais próximo de como o vemos no mundo real, mas tem gente que ainda não compreendeu isso. Se o objeto tiver 1000 comportamentos vai fazer o que?

           
          • Kaiel

            Um objeto não pode ter 1000 comportamentos simultaneamente. Boa parte dos design patterns definem métodos para desacoplar comportamentos dependentes de contexto.

             
          • Werner

            Para isso, existe um negócio chamado ‘sobrecarga’.

             
        • Kaiel

          Tive um gerência que dizia que se você precisar rolar a tela mais de duas vezes para ver o código de um método, então ele deve ser dividido.

           
          • Werner

            Isso não saiu da cabeça da sua gerência, pode crer.
            Isso é lei. Uma pena que ela seja mais ignorada do que seguida.

             
          • Victor Hugo

            … rolar duas vezes… Anotado!
            … comprar monitor grande não para deixar o código menos intuitivo… Anotado!

             
      • Luís Henrique

        dá uma lida nisso aqui para você entender o espírito da coisa, Raphael http://blog.fragmental.com.br/2007/12/28/expressividade-no-codigo/

         
      • Rafael

        Se vc precisa de um comentario para dizer oq um codigo faz é a maior prova de que ele está mal escrito!

         
        • http://felipequinto.busanello.com.br Felipe Q. B.

          Se você dispensa comentários em código é sinal de que não trabalha em uma empresa com mais de 1 programador. Falou uma baita besteira aí! hehe

           
        • Anderson

          putz… comentários são mto importantes… ou vai falar que “o seu próprio código se explica” ? já ouvi essa…

          Se tiver 2 programadores no mesmo projeto, já é impossível sobreviver sem comentários…

           
        • Aramati_

          Funções pequenas essas hein ¬¬

           
        • http://www.twitter.com/jeferod83 Jeferson Rodrigues

          É velho, concordo com os rapazes acima. Mesmo códigos muito bem escritos às vezes são complicados de entender sua lógica. Neste caso os comentários ajudam pacas.

           
        • Raphael

          O codigo pode estar bem escrito, mas se a lógica for muito extensa é melhor explicar /*Começa aqui o cadastro do cliente*/ do que ter que ler todo o codigo e descobrir que não é esse trecho que vc procurava

           
        • Fábio Martinazzo

          Eu concordo em partes…

          Às vezes você terá que fazer algo no código que foge completamente do padrão que a aplicação vinha tendo desde então… esse é o típico cenário que se exige comentários.

          Entretanto, um código bem modularizado e arquiteturado não exige tantos comentários dentro deste. O que se exige é uma documentação explicando como estão divididas as camadas da aplicação bem como bem estipuladas suas respectivas funções…

          Aqui na empresa, temos bem especificada a camada de regras de negócio da empresa contratante, aonde vai as regras como.. ao criar um projeto, gerar n contas a receber nos próximos meses, de acordo com os parâmetros.

          Isso já está dividido na aplicação em uma classe estática (criada só pra modularizar) em um namespace só pra essas classes (os de regras de negócio da aplicação). O nome das funções são específicos, e estas são curtas. Caso a função começa a ter mais escopos (agora além de gerar contas a receber, também já irá dar baixa nessas contas) então chamamos outra função pra esse fim específico:

          public static bool geraContasAReceberPorProjeto(ref Projeto objProjeto)
          {
          //Codigo
          if (!geraPagamentosContasPorContaAReceber(ref Conta objContaReceber))
          return false;

          if (!outraFuncaoQqr(ref TipoQqr outroParamQqr))
          return false;

          return true;
          }

          Uma vez recebemos uma palestra em uma empresa que eu trabalhava que focava nisso… em vez de um código cheio de comentários, um código bem modularizado é o que se espera em uma nova geração de softwares…

          Claro que passando pra uma realidade de mercado (manutenção de projetos antigos) isso é bastante inviável.. a menos que se reescreva quase todo o código…

          Aqui a empresa consegue trabalhar dessa forma, porque criamos vários projetos recentemente.

           
      • Marcos Sartori

        É mil vezes pior, a sensação te um comentário no meio do código é a mesma de alguem te chamar enquanto tu ta programando, te interrompe e tu leva uma meia hora para voltar para onde tu tava…

         
    • Luís Henrique

      issae

       
    • http://www.advotec.com.br Jeferson

      Humrum, todo mundo tem q adivinhar toda a sua logica de raciocinio ne? Por melhor q seja o código, se ele tiver muitas linhas, ter q ler e reler pra saber o q vc quis fazer é no minimo uma grande perda de tempo, que pode ser economizado com pequenos comentarios inteligentes.

       
    • /dev/random

      Ah é? Descobre o que faz isso aqui então (e tente descobrir os comentários originais deste código hahaha):

      i = * ( long * ) &y;
      i = 0x5f3759df – ( i >> 1 );
      y = * ( float * ) &i;

      Te garanto que esse código é BEEEEM expressivo.

      +1000 pra que souber :)

       
      • http://asfernandes.blogspot.com Adriano dos Santos Fernandes

        Pro John Carmack deve ser bem expressivo. :)

         
        • /dev/random

          Pena que só posso dar +1 :)

           
      • Cussuol

        Estamos falando de código expressivo.
        E o primeiro passo para um código ficar expressivo é da bons nomes para as variáveis, classes, métodos, etc…..
        No seu exemplo i e y não significam nada. Logo, é impossivel olhar para esse código e dizer o que ele faz.
        Exemplo:
        getSomaSalariosPorDepartamento(codDepartamento)
        Ele poderia ter o comentário:
        // Obtem a soma do salarios dos funcionarios de um departamento, informe o código do departamento como parâmetro.

        Mas sinceramente, precisa disso?
        Precisaria se alguem tivesse programado assim:
        getSoma(cod)

        O que sinceramente é muito comum. Tem programador que acha vantagem colocar nomes com duas ou tres letras para “digitar pouco”, e f… com todo mundo.

         
        • Hay

          O código acima não é tão simples assim. Se quiser entender melhor: http://en.wikipedia.org/wiki/Fast_inverse_square_root

          Depois, explique para mim quais nomes de variáveis você utilizaria.

           
          • /dev/random

            o cerne do código são essas 3 linhas, que dão a aproximação inicial do resultado. As outras linhas são iterações do método de newton para refinar o resultado.

             
        • Evandro Oliveira

          Impossível não é não, parceirinho. Posso te garantir.
          E nome de variável coeso não explica lógica, explica valor.

          No mais, deixo com vocês uma máxima que levo como um mantra:

          “Uma m… de código bem documentado, continua sendo uma m…
          Um bom código sem documentação te faz pensar antes de utilizar
          Um bom código bem documentado salva tempo, vidas e empregos”

          O objetivo é você não ter que se aventurar no source pra entender qual será a saída do valor inputado.

          Acho que ninguém aqui discorda que o source do PHP seja mal escrito, ou tem? Ainda assim preferimos recorrer à documentação do que ao fonte.

           
          • Evandro Oliveira

            correção “… discorda que o source … seja bem escrito…”

             
        • Rafael

          Disse tudo, isso é um código muito bem escrito e por si só não são necessários. Quanto aos zés que falam que uma classe com quinhentas mil linhas é preciso comentar, aí já está errado, a classe está fazendo mais do que devia. Princípio da responsabilidade única, o que poucos devem saber por aqui.

           
          • Victor Hugo

            Ahhh… agora entendi! Responsabilidade única é fazer coisas em poucos métodos pequenos…

            E eu que achava que responsabilidade única era outra coisa…

             
      • Albaney Baylão

        O código está mal escrito.

        Bastava criar a seguinte função :
        float FastSquareRoot(float y)
        {
        i = * ( long * ) &y;
        i = 0x5f3759df – ( i >> 1 );
        return * ( float * ) &i;
        }

        Pode não entender a matemática, mas o código é cristalino.

         
  • http://twitter.com/jonathan_hepp Jonathan

    Que tal esse:
    /*A regra é clara! Quatro espaços para identação, nada de usar Tab. Merecia uma advertência. É com você, Galvão. */

     
    • André Rosa

      Épico! E epicamente estupido, claro! Mas às vezes merecem…

       
    • Eduardo

      eu idento com tab…e nao to nem ai.eh um saco indentar com 2 espaços

       
      • DeNovo

        E quando algum infeliz abrir seu código em outro editor ou SO, ele que sifu, né? Perfeito!

         
    • Matheus

      É sério que não identa com tab?

       
  • lipelandim

    Pior quando vc vai fazer manutenção no sistema e tem um comentário assim.

    // solicitação do Cliente

     
    • louis

      e me diz qual parte do código não é solicitação do cliente?

       
      • http://pogsandlogs.wordpress.com Thassio Carvalho

        A parte que funciona…

         
      • flavio

        vá me desculpar, mas quando mandam eu fazer alguma coisa estupida e eu tenho que obedecer eu deixo o comentário “fazendo xyz devido a solicitação de fulano (gerente fulano, ou diretor fulano ou fulano da empresa abc, cliente… algo assim)”.

        Ja vivi o suficiente nesse ambiente de desenvolvimento para ver N vezes um projeto caindo no colo de neguinho que não está sabendo de nada, encontrar algo bizarro implementado e ai a culpa cair no ultimo que mexeu nisso, enquanto essa pessoa só obedeceu ordens, não é culpado…

         
        • Hay

          Ok, mas nesse caso você deixou explícito que foi solicitação de uma pessoa específica. Talvez seja interessante deixar esses comentários para o controle de código-fonte, mas enfim…

          Uma coisa é você colocar um comentário:
          // Caso especial de desconto permanente definido por
          // Fulano de Tal, para produtos da categoria XYZ. O
          // valor do produto em si não pode ser alterado pois
          // a tributação incide sobre o valor antes do desconto
          ou
          // Desconto especial – ver informações a respeito no ticket 99999

          Outra coisa é:
          // Caso especial de desconto definido pelo cliente

           
          • flavio

            concordo que o segundo comentário ficou genérico o suficiente para ser inútil…

            quanto a o lugar desse comentário ser no controle de versão, eu francamente nunca vi individuo nenhum procurar em qual commit que colocaram determinada parte de um código para falar/fazer alguma coisa dela, especialmente para falar mal…

            num mundo ideal assim seria melhor mas na prática, no mundo real é melhor deixar certas coisas mais “visíveis”.

             
          • /dev/random

            @flavio,

            svn blame é seu melhor amigo.

             
        • Fábio Martinazzo

          É o que mais dá.. =D Uma vez meu chefe ficou emputecido pq eu escrevi no código:

          //Fulano mandou retirar a linha a seguir:

          Adivinha o que aconteceu? Deu pau no cliente e ele leu o código… foi muito irado esse dia!! =P

           
  • http://regularexpression.blogspot.com Lisangelo

    Melhor seria se colocasse um /* na primeira linha e um */ na ultima.

     
    • Evandro Oliveira

      Bom, aí vc tem um comentário em bloco no meio do source e babaus de vez né??

       
      • Bardes

        Exato. Por isso que o comentário de bloco deve ser evitado e o de linha (//) foi criado para C++ e depois alguns compiladores de C passaram a utiliza-lo também…

         
    • Gustavo

      Pelo jeito não entenderam a piada. Programadores…

       
  • http://williamkennedy.com.br William Kennedy

    Pior é aqueles:

    /* não sei como funcionou, não mexa! */

     
  • http://facebook.com.br/oFabricioSilva Fabricio Silva

    …. aposto que nunca encontraram assim …
    /* que deus me ajude neste programação */
    /*testando essa linha*/……….

     
    • Cussuol

      Já achei:
      /*
      Meu Deus do céu, quem foi que programou isso?
      */

       
      • http://twitter.com/mfandrade Marcelo F Andrade

        Já fiz algumas vezes algo do tipo:

        /* Eu sei que o certo era ter feito <>, mas não ia dar até a próxima homologação. */

         
  • Fabian Ribeiro

    Tão ruim quanto não comentar é usar nome de campos e/ou variáveis que não dizem nada do que se trata tipo:

    m_c_cliente

    m de que?
    c é o que?

     
    • Mestre Silfer

      Passo por isso aqui na empresa…

       
    • http://dev-null.net/ /dev/null

      prefiro mil vezes variáveis com nomes de 30 caracteres do que essas coisas assim. Ex.:
      btnAlternarExibicaoDosControlesDeZoomNoMapa é melhor que
      b_alt_ex_cont_zo_map

       
    • http://www.rpgvale.com.br/ Bitetti

      Acho q essa mania surgiu na IBM por ideia de um japonês que programava la… pq na época vc tinha limite de caracteres em nome de variável. Hj em dia isso não faz nenhum sentido.

       
      • Cussuol

        Em cobol, a linha de comando era limitada a 80 caracteres. Era o limite do “cartão perfurado” (crianças procurem na Wikipedia).

        Alem disso, memória e disco eram carissimos e extremamente limitado, economizar cada byte era fundamental. Isso acabou levando ao bug do milênio.

        Certos velhos hábitos eram perfeitamente justificados. Continuar com eles depois que o contexto muda não é.

         
        • Aramati_

          Seu ultimo paragrafo é praticamente minha filosofia para entender o mundo

           
        • cezar

          Só existe um proplema em banco de dados grandes cada bit conta na performace

           
    • Rafael

      entao, quando tive que dar manutenção em um código que as variaveis eram T, TT, TTT
      para descobrir o que era cada uma dessas foi quase 1 hora de debug.

       
    • RasherX

      Já vi variáveis com esses nomes:

      var contadorQueFicaAoLadoDasDisciplinas = 0;
      var verticeAbertoDeMenorDistancia = 0;
      $listaAloprada = array();

       
      • Eduardo

        lista aloprada
        kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk

         
      • Gustavo

        KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK
        lista aloprada foi demais kkkkkkkkkkk

         
  • http://twitter.com/danlima Danilo

    O melhor é esse:
    /*
    * Antes, Deus e eu sabíamos o que esse código fazia.
    * Agora só Deus sabe.
    */

     
    • http://raphaelddl.com RaphaelDDL

      Aconteceu comigo já. Só que o código era meu hahah

       
  • Raphael

    /*
    * Inicia o gato chinês
    * Se False, x = 1. Se True, x = 1 também
    */

     
  • blah

    hahaha, mas é massa encontrar comentários engraçados no meio do codigo…

    pior é não encontrar nada…

     
  • Marcos Sartori

    Comentários para que? A linguagem C já limpa, bonita, simples e livre de ambiguidade. É só ler o código!

    Sinceramente, sempre que eu pego um código que não é meu e ele esta comentado, a primeira coisa que eu faço é ocultar os comentários no emacs, por que fica horrível de ler o código com aqueles Snippets interrompendo a leitura no meio, atrapalhando a identação e forçando teu cérebro a voltar para o processamento de linguagem natural enquanto tu tava rodando o algorithmo mentalmente.

     
    • :(

      {Respondendo um post idiota}
      Falou o cara que compila tudo na mente!
      {espero que não oculte o comentário do meu comentário também}

       
    • Cussuol

      Eu descordo de você quando o trecho de código é grande e complexo, justifica colocar um cabeçalho explicando o que ele faz. Pelo menos ajuda o mantenedor ter que ler a p..toda para tentar entender.
      Vai me dizer que você nunca usou o INDICE de uma publicação para evitar ter que ler ela inteira?

       
      • Marcos Sartori

        São coisas completamente diferentes e o análogo ao índice no código é o cabeçalho…

        Não sei para o nível que tu programa, mas para o nível que eu estou acostumado a programar. É muito mais fácil pegar e ler o VHDL da plataforma do que procurar na documentação.

        Portei um RTOS para a nossa plataforma virtualizada recentemente, e era muito mais simples ler as rotinas em assembly e C, procurar onde elas eram chamadas, rastrear os cenários que cada rotina aconteceria do que ler os comentários.

        Recentemente por pressão do chefe, comecei a usar doxygen nos meus códigos, deus do céu, que coisa horrível de poluída. E muitas vezes tu nem sabe o que dizer para a função, assim como muitas vezes não sabemos como nomear um variável ou função e acabamos com nomes tipo a, x,s , doTheWalk.

        Ainda bem que não trabalho com Java, morreria de fome…

         
        • Fábio Martinazzo

          Lol.. pior é você tentando dar opnião sobre práticas comuns em linguagens de alto nível, citando Assembly como referência…

           
        • davi

          “Vejam, vejam, eu programo em Assembly!”

           
    • Gustavo

      com certeza vc nunca viu uma lógica mais complicada então. Por mais que o código esteja limpo e bem escrito e vc seja “mt bom”, existem lógicas absurdas que não são fáceis de entender só lendo o código. Nestes casos o único jeito para se entender seria fazendo um teste de mesa (simulação) para entender a lógica. Concorda que se a estivesse comentado seria mais fácil???

       
  • Nícolas Fernandes

    /* Aqui é uma gambiarra pra ver se funciona esse código pra entregar para o cliente… */

     
  • https://twitter.com/nicklleite Nicholas

    Já coisas do tipo:

    //Agora, esse cara vai verificar a veracidade da variável $tal;

    ou

    /**
    * Essa função ser executada.
    **/

    hauSHUAShuasuhashuahsuhasuhuashuasHUashuASHUhuashuasuhsahu é da hora ver comentários nos códigos… revela MTO sobre o programador que fez

     
  • Luiz Eduardo

    Pow já peguei um caso sinistro
    /*
    * Área Sagrada, não alterar
    */
    Vc tirava o comentário o programa dava pau. Parece mentira, mas eu vi!

     
    • http://www.rpgvale.com.br/ Bitetti

      javascript?

       
    • Albaney Baylão

      Em alguns compiladores C e C++, existem alguns parâmetros que se passa para o compilador que são colocados dentro de comentários. Por isso, apagar um comentário pode sim fazer diferença no funcionamento do programa.

       
      • Luiz Eduardo

        Albaney mas não creio que seja esse caso. Afinal esse comentário de área sagrada é “inutil”!

         
      • @wbarbosa_

        Em Turbo Pascal e Delphi também

         
    • Aramati_

      Vi isso acontecendo com um trabalho em Java >.<

       
      • Luiz Eduardo

        Foi Java mesmo

         
  • http://felipearon.net Felipe Aron

    Lembrei de outra que quase me fez perder o almoço pela boca:

    x := 1;
    if (x 1) then
    begin

    end

     
    • louis

      e onde está o comentário?
      como eu vou saber pq o x tem q ser 1?

       
      • http://felipearon.net Felipe Aron

        Você acabou de fazer o “comentário” – kkkk

         
  • http://www.rpgvale.com.br/ Bitetti

    /*
    * Eu evoco os poderes da
    * SUPER VACA
    */

     
    • Bardes

      epic win. Eu ri muito quando vi o easter egg do apt-get… (apt-get moo)

       
  • Leandro Passos

    E já vi na faculdade, o seguinte: projeto de sistema, analiso o código, os comentários estão abarrotados de palavras de baixo calão, como se o noobie desenvolvedor se sentisse obrigado a entender o que estava escrito, por bem ou por mal. Se ele fosse trabalhar comigo ele estaria f*****.

     
  • https://twitter.com/#!/rafadu93 Rafael Duarte

    /* Um comentário vale mais do que mil documentações */

     
  • http://felipearon.net Felipe Aron

    faltou o código “diferente” no IF … não aceitou aqui

    if (x 1) then…

     
    • Cussuol

      Bons compiladores acusam isso como “Unreachable Code”

       
  • Willian Duarte

    Eu acredito no código legível por si só. Se o código precisa de comentários para ser compreendido, ou o código esta mal escrito, ou a linguagem não permite um código limpo, ou quem está lendo precisa de mais estudo.

    Já li que o comentário em código é a tentativa do programador se redimir com o próximo que pegará aquele código, deixando sua consciência limpa (ou quase). kkkkkk

     
    • blah

      não é tão simples um código legivel universal, pois existe simples coisas que alteram de forma dramática da lógica a sua, o que não quer dizer que seja não legivel, mas para o criador e muitos outros sim, mas para você e muitos outros não.

      É claro que os comentários ajudam deixando a consciência limpa, pois você está sendo gentil e detalhando o como/oq/qndo/pq (não necessariamente todos, mas pelo menos 1 creio eu) para outra pessoa que quiser implementar novas funções, ou rever a estrutura.

      Eu comento muito meu código e na minha opinião eu tenho um código legivel. Acho que voce não deve ter muita experiencia em empresa, pois existe trechos que são modificados quase que diariamente, onde eu apenas acho possível isso descrevendo como o mesmo funciona.

       
    • Jonas Torres

      Descordo!

      Há casos que é interessante o comentário da regra de negócio utilizada para a resolução do problema.

      Há casos em que você está utilizando recursos avançados da linguagem que uma minoria conhece. Neste caso é bom colocar uma referencia para um ou dois links que você achou na internet para facilitar o trabalho de outra pessoa.

       
    • Fernando Machado

      Como diria o Fowler…
      “Qualquer tolo consegue escrever código que um computador entenda. Bons programadores escrevem código que humanos possam entender.” (Martin Fowler)

      Ou ainda…
      “Sempre codifique como se o programador que vai dar manutenção no seu código fosse um serial killer maníaco que sabe onde você mora.” (autor desconhecido)

       
    • Fábio Martinazzo

      Não tão simples assim.. pelo menos não na maioria dos projetos…

      Escrevi isso láaa em cima…

       
  • Vagner

    // Dear maintainer:
    //
    // Once you are done trying to ‘optimize’ this routine,
    // and have realized what a terrible mistake that was,
    // please increment the following counter as a warning
    // to the next guy:
    //
    // total_hours_wasted_here = 16

     
    • http://raphaelddl.com RaphaelDDL

      AUHAahaHUaHU otima essa, vo colocar isso aqui numa ;D

       
  • ProgramadorREAL

    Na verdade, acho que a principal função dos comentários é se divertir… (Mandar recados, reclamar da vida, filosofar…)

     
    • http://www.rpgvale.com.br/ Bitetti

      Tem os altamente funcionais como os que avisam que é hora de parar ir tomar café e analgésico:
      // Hic Sunt Dracones

       
      • Bruno

        Quando a coisa é muito tensa eu uso “Hic Sunt Dracones et Leones”!

         
    • Apôh

      E é o que faço u.u
      Uns gostam e acham engraçado… outros odeiam meu código haha

       
  • Victor Hugo

    CRUD não precisa de comentários (se for bem escrito). Comentário não é para substituir nada, é para deixar clara a funcionalidade de um bloco de código. Porém, nem todo o código é tão simples.

    Qual o número mágico para a quantidade de linhas?

     
    • /dev/random

      42

       
      • Yuri Marques

        anotado! 0/

         
      • Eduardo

        o numero fundamental

         
      • xelamitchell

        Hmmm, na verdade nao seria 69,105?

         
  • Albaney Baylão

    Lendo os comentários percebo que existem dois extremos inválidos por aqui: aqueles que acham que comentário é essencial, e aqueles que acham que comentário é dispensável. Se você comenta para explicar **O QUE** o seu código faz, então ou o seu código é muito mal escrito ou o seu comentário foi dispensável. Agora **POR QUE** você fez daquela maneira e não de outra? Quais são as premissas que aquele seu código tem? O que você espera que seja verdade quando aquele código estiver sendo executado? Isto é essencial ser documentado!

     
    • Fábio Martinazzo

      Totalmente de acordo.

       
  • Felipe

    Eu já vi piores, tipo:

    //Refresqueia o check
    checkbox1.refresh();

     
    • http://www.rpgvale.com.br/ Bitetti

      “refresqueia” !? Check box colorida ?

       
      • http://www.felipekm.com Felipe

        Nem pergunte porque eu desisti de entender.
        Pra variar o Super Star que faz esse tipo de coisa dessas já deixou a empresa, por que será né?

         
      • JOÃO PAULO

        Não, deve ser CheckBox Fresca. kkkk

         
  • Mestre Silfer

    Comentário para ajudar a entender a lógica é sempre útil.
    Principalmente em procedures SQL.
    Outro detalhe é evitar a perda de tempo de ler o código inteiro cada vez que você vai dar manutenção ou precisa parar no meio. Imagina ter que reler todo código já pronto, porque precisou parar a codificação no meio?
    Acho comentários sempre válidos.
    Mas iguais aos do Alonso… totalmente dispensáveis

     
    • Aramati_

      Pois é, o pessoal que diz que codigo bem feito dispensa comentarios deve estar pensando em casos assim:
      // função para calcular salario
      public calculaSalario( double salarioBase, double descontos, double bonus){

       
    • Rafael

      A partir do momento que um sistema precisa utilizar procedures SQL que contenha regras de negócio, ele mesmo já está todo errado!!! Procs jamais!!!

       
      • http://www.rpgvale.com.br/ Bitetti

        Uma store procedure vc usa para manipular os dados de forma mais complexa, não necessáriamente as regras de negócio mas atualizar um campo com suas meta-tabelas já é caso legítimo para uma procedure.

        Se vc visse a faculdade aqui do lado … resolveram ensinar aos alunos que se podia fazer um sistema unicamente com o banco e suas procedures! Ai sim eu concordo que tinha q matar!

         
        • Fábio Martinazzo

          Eu também não faria… mas Oracle é um SGDB que leva isso bastante a sério:

          Breve resumo sobre Oracle Forms

          A idéia que ele propõe, até onde eu li é a de manter as regras basicamente em triggers… (Algo que eu realmente não faria…)

           
  • http://botecogeek.com/ Leandro Correa dos Santos

    os comentários podem poupar tempo, explicando o que aquela função vai fazer, sem que você tenha que interpretá-la mentalmente. Isso economiza tempo na manutenção. Gosto de colocar pequenos comentários mesmo que o código esteja bem escrito, para facilitar o trabalho.

    Outras pessoas, mesmo que tenham seu nível de conhecimento, precisam entender a lógica usada no código.

    Chefe gosta de muitos comentários nos códigos. Assim, se um dia ele contratar algum Alonso da vida, fica mais fácil ele entender como as coisas funcionam (sem que ele fique o dia todo no seu pé).

    No meu trabalho já encontrei comentários do tipo
    # powered by Chico Xavier

     
    • http://www.rpgvale.com.br/ Bitetti

      Esse ai não precisa de bola de cristal

       
  • Davi

    Documentação ta ai pra ajudar =D

     
    • cezar

      ou não

       
  • http://novidad.es Felipe Barth

    Já vi uns assim

    /* Aqui começa a mágica */

    /* Aqui começa o efeito cascata boa sorte */

    /* Para saber como funciona essa função pergunte para o Mauro */ Obs: Nunca trabalhou um Mauro aqui.

     
    • Saraiva

      Deve ser o Mauro do Vidadesuporte!

       
  • Rodrigo VM

    Comentário na minha opnião leva ao erro.

    Uma situação muito comum é o programador colocar um comentário do tipo:

    /*** calculo de financiamento ****/
    /*** Formula: (valor / parcelas * taxa) + (periodo * taxa ….) */

    Bem, depois de um tempo, mudam a formula do financiamento, mas não mudam o comentário…

    Depois de uns anos, algum gerente quer entender como é feito este cálculo por algum motivo, outro programador vem e só lê o comentário e passa a formula errada.

    Comentarios de mudanças, correção de bugs, quem realizou e etc… São interessantes no repositório.

     
    • Fábio Martinazzo

      Bom.. esse foi um perfeito exemplo do MAU USO de um comentário… eles podem ser muito benéficos quando usados de forma apropriada.

       
  • JEloy Al Majid

    /*
    Comentei as linhas abaixo, porque essa m… está toda bugada. O FDP que escreveu
    esse código não tem um pêlo no c*. De tanta m… que fez que não foi homem de pôr uma
    única linha de comentário assinando a obra.

    E se achar ruim essa p… de comentário venha falar comigo.

    Firegun
    07/JUN/2010
    */

     
  • Xtian Xultz

    Eu não escrevo comentários, eu escrevo romances, eu tenho mais comentários que códigos. Mas eu faço isso prá me proteger de mim mesmo, basta algumas horas e eu não faço mais a menor ideia do que o código que acabei de escrever faz. Eu sei, eu sou um mané, mas que que eu posso fazer…

     
    • Rafael

      concordo, com a correria que se passa no dia a dia fica dificil relembrar toda a lógica do que o processo que voce esta dando manutenção tem que fazer, ainda mais multiplicando a quantidade de clientes e sistemas que cada um pode possuir.

       
    • @wbarbosa_

      Regra que uso: 1 linha de comentário a cada 5 a 10 de código (Linhas em branco não contam!)

       
  • anderson

    function faznada(){
    /*
    script bundao faz nada
    */
    }

    /* pog para IE by FULANO */

    /* melhorar este código depois */

     
  • renan

    //abre a tela inicial
    abreTela(“inicial”);

     
  • http://www.e-brand.com.br @derlandyb

    Já teve do tipo:

    /* Se chegar aqui fu*** */

     
  • @ProgramadoraBR

    Eu faço cada comentário idiota. Em uma equipe com muitos programadores às vezes a gente faz uma coisa e vem um sem avisar e mexe. Da muita raiva… Então eu comento assim: //Feito por Claudia. Antes de mexer me avise.

     
    • Werner

      E depois q vc saiu da empresa, como é q faz? Liga no celular?

       
  • Virgilio Ximenes

    Javadoc taí pra isso!!

     
    • http://jennymetal.wordpress.com Jenny

      Que bom que todas as tecnologias usam javadoc né?

       
  • http://www.e-brand.com.br @derlandyb

    Pior mesmo é quando o comentário diz uma coisa, o nome da função nem de longe remete ao comentário e o que o código faz não é nem uma coisa nem outra.

     
    • Aramati_

      Epic coment is epic

       
  • Márcio Almada

    Precisava mesmo de tantos comentários pra dizer que comentários ñ tem importância?

     
  • http://www.nicolastarzia.com/blog Nicolas Tarzia

    Já peguei umas coisas grotescas igual a essa:

    /*
    1 , 2 , 3 já contei agora é sua vez e conte em japones…
    */

    ou então:
    /*
    As tranças de Rapunzel…
    */

    O que você espera de um código desse? rs

     
  • Celso

    Ja vi um comentario assim:

    …e resolve todo o problema…FANTÁSTICO NAO ACHAM!!!

    eu juro que chamei uns colegas pra ver q por sinal nao foram nenhum
    q escreveu aquilo né? tb quem vai assumir com o chefe ao lado kkkkkk

     
  • Heitor Silva

    E quem já viu
    /* função papel higienico */
    ?

     
    • Saraiva

      Lembrei do ex-chefe que dizia: “Manutenção é igual papel higienico, só entra em campo depois da M***@ feita!”

       
  • Andre Luiz

    Nossa! Nunca imaginei que minha sugestão de tirinha seria tão comentada em tão pouco tempo (risos)!

    Acho que o principal problema de comentários é que o pessoal escreve o que não precisa e não escreve o que precisa. Por exemplo, nunca acho arquivo-fonte com um comentário no início explicando a arquitetura do programa, a interação entre as threads, etc., mas sempre acho coisas do tipo:

    // Alocando o buffer
    byte[] Buffer = new byte[BufferSize];

    // Incrementando o contador
    Counter++;

     
    • http://www.rpgvale.com.br/ Bitetti

      isso é RCP de exemplo da Internet

       
    • Werner

      Isso me parece coisa de programador Assembler.

       
      • http://www.howtogeek.com/96780/how-to-rename-internet-explorer-to-firefoxchrome-downloader/ Werner

        Ué, não entendi por que motivo meu comentario acima foi negativado…
        Falei bobagem? Quando eu programava em assembler 8051 era um comentário por linha mané.
        Ou como vc acha q depois eu ia saber pra que eu tinha escrito o tal do ‘JNZ 0x0FF’?

        Tem cada um sem noção mesmo.

         
        • Saraiva

          Meu projeto final para Téc. em Eletrônica…
          Relógio digital com 80S52 e LCD 16×2. E a semana ficou bugada- não passava pra “ter” nem ferrando.

           
  • Bruno

    Isso aqui é tudo obra de uma mesma pessoa:

    // Faz as coisas que tem que fazer

    //NumAnterior : String; // Tem por objetivo eliminar um efeito colateral que
    // ainda não consegui eliminar.

    // Em comentario para ver se funciona…

    GetNumero + // Tomei emprestado. Nao precisa devolver, hehe

    { Incluido para o cliente XXXXX. E seja o que Deus quiser…}

    Isso é só parte dos comentários, o código é bem pior!

     
  • http://www.aprenderprogramar.com.br Renato Louro (@rslouro)

    Não é interessante que a tirinha sobre comentários esteja para bater o record de comentários?

     
    • Velho Chato

      Não

       
      • http://www.aprenderprogramar.com.br Renato Louro (@rslouro)

        Chato…

         
  • rgrlinux

    Acho que para tudo existe o bom senso, gosto muito do livro Código Limpo, e sempre sigo suas teorias, comentários somente onde é extritamente necessário, funções e váriaveis com nomes claros indicando para que e o que fazem, comentáros redundantes só atrapalham, assim como numeros mágicos e variaveis com nomes extranhos, alguns ai comentaram que algumas funções eram curtas, esta é uma das sinteses do livro, se um função ou precedimento tem muitas linhas é por que ela esta fazendo mais de uma coisa e cada funcao ou procedimendo deve fazer bem uma coisa somente. a e também não adianta comentar e não atualizar, atrapalha mais ainda.

     
  • Waldney Andrade

    “Agora vou escrever: Irmãos e irmãs, vamos brincar de aprender a ler, e parar de ficar discutindo #$%#!#. ”

    Irmãos e irmãs, vamos brincar de aprender a ler, e parar de ficar discutindo #$%#!#.

     
  • Darkmatter

    Opa já entrou no box de tópicos mais comentados hehe

     
  • Werner

    Uahahahahah, adorei a camiseta!!
    😀

     
  • Dudu

    Na verdade “código limpo” costuma ter pouco ou nenhum comentário…
    Se precisa realmente de comentários, pode ser um “bad smell”…
    :)

     
    • http://www.aprenderprogramar.com.br Renato Louro (@rslouro)

      Pode ser do verbo “Não necessariamente”? Então…

       
  • http://www.rpgvale.com.br/ Bitetti

    Tenho manias de colar links de fontes de referência nos comentários.
    Esses dias errei de aba no navegador e colei um link do Sedentario tipo “Segunda rima com bunda”
    Por algum motivo naquela tarde o rendimento do pessoal caiu para zero.

     
  • Marcos A. Lucas

    Comentário preferido por um amigo meu, toda vez que ele editava algum código mais “complexo”:

    /* WELCOME TO THE JUNGLE! */

     
  • http://kalug.net/ kAlug

    Mais alguns exemplos de comentários: StackOverflow (pena que tiraram de lá)

     
  • Albaney Baylão

    Alguns comentários: ;^)

    1) Se você precisa de um comentário pra dizer o que uma função/método faz, você escolheu mal o nome dela.
    2) Se você precisa de um comentário pra dizer o que uma variável armazena, você escolheu mal o nome dela.
    3) Se você bater o olho no código de uma função/método faz, ou você não sabe direito a linguagem ou ela faz algo que deveria ser quebrado em duas ou mais funções.
    4) Se alguém que sabe a linguagem demora mais do que 5 segundos para entender o que uma função/método faz, o autor deveria ter quebrado ela em duas ou mais.
    5) Comentários devem conter principalmente informações que não estão presentes no código. De preferência apenas informações que não estão presentes no código.

     
    • Marcelo Fuchs

      Concordo Plenamente!

       
    • Troller

      Quando você programa então não usa documentação, estilo Javadoc ? Você sabe, só de ver o nome, o que o método espera e o que ele vai retornar ? Você nunca acessa a internet pra procurar a documentação de algum método de algum biblioteca, porque afinal, tudo é “tão óbvio” ?

      Você está realmente num nível muito acima dos outros mortais.

       
      • Albaney Baylão

        Troller,

        a) Se você faz um comentário por que uma ferramenta geradora de documentação pegará este comentário e gerará a documentação então este comentário não se encaixa em nenhuma das categorias acima.

        b) Se você procura na internet o que faz um método ou função é por que você não está vendo o código dela e portanto você não está se encaixando em nenhuma das categorias acima.

        c) Eu nem sempre sei só de olhar o nome de um método/função o que ele faz. Quando isto acontece é por que o nome foi mal escolhido. Mas o critério não sou eu. Se qualquer um que saiba o básico de programação olha o nome e não sabe o que a função faz, então o nome foi mal escolhido.

        Houve um tempo em que os nomes das variáveis e funções eram curtos para economizar espaço em memória, ou para economizar digitação. Hoje com memória farta e IDEs que autocompletam a digitação não há por que usar nomes descritivos para as funções e métodos.

        O seu código deve ser o mais auto-explicativo possível, com nomes de variáveis/atributos e de funções/métodos claros e que dispensem comentários.

        Agora, as boas razões para se usar comentários:

        A) Geração automática de documentação.
        B) Explicar as premissas embutidas no seu código. Por exemplo, você pode dizer que a função/método por razões de desempenho espera que os valores passados sejam sempre válidos e portanto não testará os parâmetros por valores inválidos. Se a premissa neste exemplo é válida ou não é outra discussão.
        C) Explicar as razão de por que o código foi escrito daquela maneira e não de outra.
        D) Lembretes para o futuro. Exemplo /* escrevi este código de forma porca e com pressa, melhorar quando possível */ ou /* alterar este método quando o sistema trabalhar com múltiplos bancos de dados */

         
        • http://twitter.com/mfandrade Marcelo F Andrade

          Perfeito, Albaney!

           
  • /temp/

    /* Escrevi a query, consultei no banco, fiz um fetch_array e um while */…

    True Story

     
  • Marcelo Fuchs

    Eu já ví :

    /**
    * Encontra baltazar
    */
    Public changeBaltazar() {

    }

    ou
    /*
    * Função que salva o aluno.
    /*
    Public salvarAluno (Aluno aluno) {

    }

     
  • http://rockmeon.wordpress.com Priss Guerrero

    Com certeza esses comentários estão muito bons! Gostei das aulas!

     
  • Gabriel Queiroz

    Pergunta de noob: o que quer dizer a palavra “trin” na camiseta?

     
    • Andre Luiz

      A palavra, na verdade, é “trim”. É usada para designar métodos/funções que removem espaços em branco do começo e do final de uma cadeia de caracteres (acho que com isso dá para entender o humor da camiseta :-) ).

       
      • Gabriel Queiroz

        Obrigado

         
    • Werner

      Tá de sacanagem??

       
  • Pingback: DB2.02 – Documentação e Organização do código « Banco de Dados()

  • http://www.ctmts.com.br Erick-Master

    Eu já comentei uma vez em um script recente:

    //---------------------------------------------------------
    // Oh shit, nothing accounts VIP?
    //---------------------------------------------------------

     
  • http://twitter.com/mfandrade Marcelo F Andrade
  • http://www.niinformatica.com.br Pecinato

    Infelizmente concordo com muitos que ja comentaram e falaram que pegar os codigos dessa forma se torna normal.

    Cada codigo que pegamos que da ate tristeza, nao possui documentação e os codigos estao com comentarios errados ou nem se quer possuem comentarios.
    Isso leva noites acordado para resolver e descobrir totalmente o sistema.

    Mais uma tirinha da vida de programador.

     
  • http://.............................. gilberto zitoski

    Ahhh não isso não dah… muit doido.

     
  • Kepler


    // No time to change this for the moment
    //
    // ( )
    // ( ) (
    // ) _ )
    // ( \_
    // _(_\ \)__ Merde!
    // (____\___))
    //

    #define please_do_not_vomit
    #include "sys.ho"
    #undef please_do_not_vomit

     
  • pogueiro

    /**
    * @param activeEntity Atribui a propriedade ‘activeEntity’
    */
    public void setActiveEntity(Serializable activeEntity)
    {
    this.activeEntity = activeEntity;
    }


     
    • pogueiro

      Apesar do apelido, este comentario não é meu não.

       
  • http://www.google.com.br luciano

    Apesar do apelido, este comentario não é meu não.

    Avalie

     
  • João

    Legal mesmo foi um comentário em C++ que eu vi que estava assim:
    #define TRUE FALSE //Divirtam-se debugando otários!!

    Mas mais legal ainda foi:
    #define NULL (::rand() % 2) // trollface

     
    • @wbarbosa_

      Na minha terra isso tem outro nome: filhadaputagem!

       
  • Vinicius

    Bem, na empresa que trabalho, sou único programador na equipe (único formado da faculdade de programação). A equipe inteira programa os básicos e entende os scripts sem precisar de comentários! Isso é muito bacana! Aprendi lendo códigos deles em como deixar códigos mais fáceis até para iniciantes.

     
  • http://www.vardomirices.com.br Fex

    Pra ter um código bem comentado tem que chamar o Arnaldo Cesar Coelho.

     
  • http://aldeyf.wordpress.com Aldey Freire

    // Loucura? ISSO É ESPARTA!