Comments on: Código que fala por si só

By: Leila

Leila — Sun, 09 Aug 2009 02:24:03 +0000

Concordo. O código deve ser claro e simples. É possível compreender código alheio quando está bem estruturado. Depois de estudar por algumas horas, normalmente consigo ter uma idéia do todo. Comentários ajudam, mas nomes de variáveis, métodos e classes bem escolhidos fazem toda a diferença. Há exceções à regra, claro, mas normalmente são algoritmos intrisicamente complicados, nos quais poucos desenvolvedores/pesquisadores trabalham.

By: Rafael Ponte

Rafael Ponte — Tue, 16 Jun 2009 03:06:27 +0000

Como diria Uncle Bob:
“Professionals write clear and clean code.”

Quando você encontra código com muitos comentários tentando explanar o que está ocorrendo então há grandes possibilidades de ali haver um “bad smell”.

Excelente post, parabéns.

By: Willie Oliveira

Willie Oliveira — Mon, 15 Jun 2009 13:20:47 +0000

Concordo e considero a documentação como uma manchete de uma notícia que o código irá contar.

Em jornais, somos atraídos por aquilo que realmente nos interessa através de uma manchete, nos evitando varredura completa página a página, no entanto, identificada a página, se o texto redigido não for lá estas coisas, perdemos o interesse rapidamente e iniciamos a busca por notícias mais interessantes.

Trazendo para o ambiente de desenvolvimento, nem sempre é possível descartar um código para colocar outro em seu lugar, e como dito pelo Thiago “todo bom escritor pensa o tempo todo em seus leitores, pense o tempo todo em quem vai ler seu código”.