tag:blogger.com,1999:blog-1287486120180593203.post682444224446653673..comments2023-08-22T04:35:10.682-03:00Comments on Mais que bom código: // Não comente seu códigoDirlei Dionísiohttp://www.blogger.com/profile/08502034198594794171noreply@blogger.comBlogger25125tag:blogger.com,1999:blog-1287486120180593203.post-1944438884821030752012-11-13T16:37:02.956-02:002012-11-13T16:37:02.956-02:00"Sempre codifique como se o programador que v..."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)<br /><br />kkkkkkkkkkkkkkkkkkkkkkkkkkkkkk<br /><br />muito boaa kkkkkkkkkkkkkkkkkkkAnonymousnoreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-30657062060214937232012-03-26T23:38:47.122-03:002012-03-26T23:38:47.122-03:00Tem certeza que sabe, Anônimo? Brincadeira, estou ...Tem certeza que sabe, Anônimo? Brincadeira, estou apenas sendo irônico, como fui no comentário anterior. Bons programadores que também são bons professores são raros, mas não duvido que existam. Parabéns por ser um deles. Abraço!Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-40830326962266465402012-03-26T23:00:09.830-03:002012-03-26T23:00:09.830-03:00Concordo plenamente, Anônimo. Foi por isso que não...Concordo plenamente, Anônimo. Foi por isso que não generalizei.Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-84862850361265875302012-03-26T21:54:11.558-03:002012-03-26T21:54:11.558-03:00Não concordo que um código bom não deve ter coment...Não concordo que um código bom não deve ter comentario. O comentário serve para descrever o que será feito.<br />um exemplo é se você faz uns calculos com valores de ICMS, vc precisa descrever de onde veio esses valores.<br />Cada caso é um caso. não podemos generalizar.Anonymousnoreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-66112051348294830712012-03-13T02:22:11.537-03:002012-03-13T02:22:11.537-03:00Discordo e com prova, sei fazer mas adoro ensinar,...Discordo e com prova, sei fazer mas adoro ensinar, então faço durante o dia e ensino anoite;Anonymousnoreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-6131092051410539792011-10-31T01:32:07.444-02:002011-10-31T01:32:07.444-02:00Neste ponto, sem dúvida que tenho que concordar, a...Neste ponto, sem dúvida que tenho que concordar, afinal, comentário deve ser útil e não redundante ... lembro quando perdi ponto em trabalho por falta de comentário e decidi comentar tudinho só pra encher o sacoDarthjeehttps://www.blogger.com/profile/03105406552116955640noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-36021282011879224282011-10-28T16:31:43.932-02:002011-10-28T16:31:43.932-02:00Olá Darthjee, obrigado pela visita e pelo comentár...Olá Darthjee, obrigado pela visita e pelo comentário. A intenção do artigo foi desestimular o uso dos comentários que tentam compensar a má qualidade do código. Código ruim deve ser refatorado, não explicado com comentários. É claro que sempre haverá comentários dignos de serem escritos e eu citei alguns desses exemplos. Um código Assembly certamente tem mais motivos para ser comentado que códigos em linguagens de alto nível, mas o princípio continua o mesmo: não usar comentários como desodorante.<br /><br />Grande abraço!Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-6882377758491176502011-10-28T15:43:25.080-02:002011-10-28T15:43:25.080-02:00um javadoc geralmente basta, fala pra que serve, e...um javadoc geralmente basta, fala pra que serve, etc.Rinaldihttps://www.blogger.com/profile/07979325985132709598noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-91029604787077819172011-10-28T14:25:33.214-02:002011-10-28T14:25:33.214-02:00na verdade, existe um ponto não abordado aqui
nem ...na verdade, existe um ponto não abordado aqui<br />nem todas as linguages prevem um código limpo (imagine programar em assembler sem comentar)<br />ou as vezes, temos um algorítimo maluco demais, mas eficiente, por isso ele vai precisar de comentários (as vezes programamos para máquinas de baixo desempenho)<br />portanto concordo com os pontos apresentados, mas não com a conclusão finalDarthjeehttps://www.blogger.com/profile/03105406552116955640noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-52497943238162001402011-06-28T23:54:36.236-03:002011-06-28T23:54:36.236-03:00Bacana, Leonardo! Gostei do artigo, até deixei um ...Bacana, Leonardo! Gostei do artigo, até deixei um comentário lá. Li ainda alguns outros artigos e informações sobre a empresa. Me pareceu um ótimo lugar para trabalhar.<br /><br />Valeu pela visita e pelo comentário!<br /><br />[]'sDirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-90322026216653054812011-06-28T21:03:42.123-03:002011-06-28T21:03:42.123-03:00Olá. Muito bom o texto!!!
Dê uma olhada neste aqu...Olá. Muito bom o texto!!!<br /><br />Dê uma olhada neste aqui também:<br />http://blog.qualidata.com.br/?p=669<br /><br />Abraços!Leonardo Moulin Francohttp://bommesmo.comnoreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-86714525433320591802011-05-23T20:49:34.620-03:002011-05-23T20:49:34.620-03:00Obrigado, Alonso!Obrigado, Alonso!Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-90196351139524914712011-05-23T20:20:46.727-03:002011-05-23T20:20:46.727-03:00Muito bom artigo. Também sou totalmente contra com...Muito bom artigo. Também sou totalmente contra comentários. Acho que(quando o código é bom, lógico), comentários só servem pra ensinar a quem não sabe programar. Por mais que o código seja limpo, sempre vai ter alguém que não vai entendê-lo. Mas nesse caso é provável que nem os comentários ajudem...<br /><br />Parabéns pelo blog!Alonso Jr.https://www.blogger.com/profile/13260730172804386401noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-64043557926172835832010-09-19T09:20:57.332-03:002010-09-19T09:20:57.332-03:00Se seus comentários quase sempre são um pleonasmo,...Se seus comentários quase sempre são um pleonasmo, isso é ótimo! Sinal de que seu código está claro e autoexplicativo. Ocasionalmente você pode experimentar acrescentar aos seus comentários redundantes algo como:<br /><br />"Me desculpe por este comentário redundante, é que há programadores que não sabem que código bom é código que não precisa de comentários."<br /><br />Hehehe... <br /><br />Um abraço!Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-5344107611581329372010-09-19T02:57:07.909-03:002010-09-19T02:57:07.909-03:00Eu costumava usar milhares de comentários. Até o d...Eu costumava usar milhares de comentários. Até o dia em que apaguei TODOS os comentários em uma classe (header e source, em c++) e me forcei a explicar o código mentalmente.<br /><br />Simplesmente não consegui explicar um código que EU havia escrito.<br /><br />Depois disso, passei a tomar muito cuidado e a tentar deixar o código auto-explicativo. Hoje comento em algumas partes do código por haver muita gente que torce o nariz se não ver alguns "//" espalhados. Mas na maior parte das vezes considero quase um pleonasmo, rs.Daniel Brunohttps://www.blogger.com/profile/01689705107129025957noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-30516874071720495382010-08-11T09:16:59.076-03:002010-08-11T09:16:59.076-03:00Legal ter alguém da comunidade Rails no meu blog! ...Legal ter alguém da comunidade Rails no meu blog! Obrigado pelo comentário, Samuel! [ ]'sDirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-16892641790187073162010-08-10T14:37:10.442-03:002010-08-10T14:37:10.442-03:00Não conhecia o blog, mas achei o post muito bom.
...Não conhecia o blog, mas achei o post muito bom.<br /><br />Parabens!<br /><br />Com relação ao TODO isso realmente é ótimo. No meu caso, que uso Ruby on Rails, ele já é nativo da linguagem = )Samuel Viníciushttp://www.casaopen.com.brnoreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-46125364457401984542010-07-24T15:10:10.490-03:002010-07-24T15:10:10.490-03:00Muito obrigado Raquel!
Sobre a exibição dos comen...Muito obrigado Raquel!<br /><br />Sobre a exibição dos comentários com "TODO" nas IDE's...<br /><br />Eclipse -> Window/Show View/Tasks<br />Netbeans -> Window/Tasks<br />Delphi -> View/To-Do-list<br /><br />Um abraço!Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-19202194074173999332010-07-24T02:04:24.156-03:002010-07-24T02:04:24.156-03:00Achei interessante o que você disse sobre as IDE&#...Achei interessante o que você disse sobre as IDE's de desenvolvimento modernas permitirem a fácil localização dos comentários marcados com "TODO". Pode me dar alguns exemplos?Raquel Machadohttps://www.blogger.com/profile/10265758505206572479noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-48030300038698106542010-07-24T01:59:58.483-03:002010-07-24T01:59:58.483-03:00Parabéns pelo blog, adorei o jeito como você escre...Parabéns pelo blog, adorei o jeito como você escreve! Também acho que comentários são bons pra quem não conhece muito uma linguagem,assim coloca umas "colinhas" sobre determinada linha de código e dessa forma acaba fixando.<br />Adorei isso rs "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." Beijos!Raquel Machadohttps://www.blogger.com/profile/10265758505206572479noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-38897744843255029562010-07-21T15:59:12.699-03:002010-07-21T15:59:12.699-03:00Na minha visão, os comentários visam o objetivo de...Na minha visão, os comentários visam o objetivo de explicar o "porque?" e não o "para que?".<br /><br />Não escrevo um comentário dizendo o que um método faz.Isso é por conta da assinatura do método. <br /><br />Por exemplo:<br />Ecrevo um comentário, em alguns casos, explicando o porque foi criado um método "igual" a um outro já existente. Isso pelo fato do comportamento interno do método em alguns pontos serem diferentes.<br /><br />Parabéns pelo blog e um Grande abraço!Alexandrenoreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-25319643557796053732010-07-20T23:24:20.954-03:002010-07-20T23:24:20.954-03:00Você tocou num ponto que eu não tinha pensado: que...Você tocou num ponto que eu não tinha pensado: que comentários são úteis durante a fase de aprendizado. É engraçado que hoje mesmo encontrei um monte de comentários um tanto óbvios num código que escrevi uns anos atrás onde trabalho (foram escritos por um estagiário que estava estudando o software pra assumir a manutenção).<br /><br />Volte mais vezes Gustavo! Um abraço!Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-26356755766235596912010-07-19T10:23:37.358-03:002010-07-19T10:23:37.358-03:00Muito bem lembrado...hoje em dia as linguagens de ...Muito bem lembrado...hoje em dia as linguagens de alto nível já tornam a comunicação entre os programadores e o computador muito simples, não há a necessidade de comentar que //2+2 = 4. O comentário é bom pra quem não conhece muito uma linguagem e está estudando ainda...<br /><br />Parabéns Dirlei...blog muito interessante! AbraçoUnknownhttps://www.blogger.com/profile/09287957538880543490noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-32288655140526876942010-07-18T22:37:10.602-03:002010-07-18T22:37:10.602-03:00Essa sua história do professor me lembrou o que o ...Essa sua história do professor me lembrou o que o diretor de uma empresa onde trabalhei dizia: "Quem sabe faz, quem não sabe ensina".<br /><br />Obrigado pelo comentário! Um abraço, Magno.Dirlei Dionísiohttps://www.blogger.com/profile/08502034198594794171noreply@blogger.comtag:blogger.com,1999:blog-1287486120180593203.post-5329417868533749732010-07-18T07:42:28.341-03:002010-07-18T07:42:28.341-03:00Concordo totalmente. Melhor do que código todo com...Concordo totalmente. Melhor do que código todo comentário, é código que simplesmente não precisa de comentários.<br /><br />Eu tive um professor na faculdade que dizia que tirava ponto dos alunos que não comentavam os códigos nas provas e trabalhos. Na época eu achei a atitude dele o máximo, mas hoje vejo que o professor estava tremendamente equivocadoMagno Machado Paulohttp://blog.magnomachado.com.brnoreply@blogger.com