quarta-feira, 2 de janeiro de 2008

Expressividade no Código

Hoje vou recomendar a leitura deste post -> "Expressividade no Código"

Veja um trexo do que você vai encontrar neste post....

"E logo surge alguém sugerindo que deveria haver documentação. Existem casos onde documentação, seja JavaDoc, especificação funcional ou etc. é fundamental mas neste caso é diferente. JavaDoc, especificação textual e etc. devem ser uma fonte importante quando que está interessado nessa informação não vai lero código, é como reutilizar uma biblioteca ou um framework. Ninguém quer abrir o Spring para entender como utilizá-lo, precisamos de documentação para isso."

Muito bem dito não é mesmo?
O trexo acima é importante de se ter em mente, principalmente quando você se confronta com um gerente que não sabe pra que serve uma documentação, e ele te afirma que basta olhar a documentação, que a tarefa deve ser feito rapidamente em alguns minutos, afinal a documentação esta bem escrita e com ela o desenvolvedor deve conseguir encontrar o problema e soluciona-la sem grandes problemas..... tcs tcs tcs.


Expressividade no Código

Nenhum comentário: