Comments on: Expressividade no Código

By: Padrões de Projeto e Expressividade de Código - Rodrigo Allemand

Padrões de Projeto e Expressividade de Código - Rodrigo Allemand — Mon, 02 Mar 2009 18:57:05 +0000

[...] expressividade no seu código é 80% de um código bem feito! Se alguem entende o que vc se propoz a fazer, as possiveis [...]

By: Saga do programador » Equipes novas, Manias antigas…

Saga do programador » Equipes novas, Manias antigas… — Fri, 13 Feb 2009 03:35:30 +0000

[...] a reação que as expressões “código expressivo” e “modelo de domínio rico” provocam na maioria das pessoas. Caretas e narizes torcidos [...]

By: Marlon Patrick

Marlon Patrick — Sun, 21 Sep 2008 05:26:38 +0000

Muito bom cara..
super esclarecedor, de uma maneira simples e direta..
gostei muito..
principalmente por que to querendo me aprofundar nesse tema: Refactoring.
Lendo esse artigo me empolguei de vez..
parabéns.

By: pcalcado

pcalcado — Sat, 05 Jan 2008 02:10:25 +0000

Se você possui estes valores na tela provavelmente eles são parte do negócio, não? Se forem parte do negocio então deveriam estar no modelo de objetos, logo a mesma situação se aplica.

By: Marcilio

Marcilio — Fri, 04 Jan 2008 00:35:21 +0000

Mto bom.
Fui eu quem abriu a discussão no Guj. Foi um dia de revolta.
Pegando no exemplo da sua classe, imagine que temos uma tela de vendas super complexa, onde temos as variaveis:
xPre, xPreDolar, xPreco, xPrecoCalculado e por ai vai…
duro no ínicio p´saber o q cada uma representa…
A ideia de Refactoring é mto boa, mas inútil em alguns casos.

By: André Pinto

André Pinto — Wed, 02 Jan 2008 14:23:42 +0000

Em alguns casos acho melhor não ter documentação nenhuma do que ter uma documentação desatualizada há séculos… Acho que nomes de métodos, classes e atributos auto explicativos são essenciais para uma boa manutenção. E é claro: testar sempre!

By: Leandro

Leandro — Wed, 02 Jan 2008 12:24:31 +0000

Odeio códigos asquerosos! rsrsrs

Que o código fale por si…

By: elomarns

elomarns — Tue, 01 Jan 2008 08:56:19 +0000

Excelente artigo!

Eu sempre acreditei que documentação, incluindo comentários no código fonte, só deve ser criada se ela de fato agregar algum valor ao projeto.

Como você bem disse, uma vez criada a documentação, ela terá que ser atualizada em várias ocasiões, e a menos que ela tenha uma utilidade bem concreta, esta atualização será um enorme desperdício de tempo e recursos.

Talvez eu seja meio extremo nesse sentido, principalmente em relação aos comentários no código fonte, mas ao ler, por exemplo, o seu código, eu reforço a minha opinião, já que ele fala por si só, não só dispensando qualquer documentação, como também se tornando, de certa forma, uma espécie de documentação(mais ou menos como prega o BDD, se não me engano).

P.S.: Só pra evitar interpretações errôneas, eu não sou contra comentários, apenas sou contra comentários desnecessários. Um exemplo disso seria comentar simples getters/setters ou váriaveis com nomes significativos, como uma variável de instância chamada dataDeNascimento em uma eventual classe Cliente.

Além disso, também sou, na maioria dos casos, contra comentários que esclarecem aspectos da sintaxe do código, ao invés de focar na sua semântica, que é o que realmente importa.

By: Marcos Silva Pereira

Marcos Silva Pereira — Sun, 30 Dec 2007 02:18:25 +0000

E eis o meu ponto da discussão do GUJ: se o código já foi escrito de maneira clara o suficiente, para que raios gastar mais tempo escrevendo javadoc? Faz sentido? É util?

valeuz…

By: Clavius Tales

Clavius Tales — Fri, 28 Dec 2007 22:43:49 +0000

“Post” antológico! Parabéns!