[SP-pm] Documentação de cabeçalho de rotinas

Otávio Fernandes otaviof em gmail.com
Sexta Janeiro 11 07:34:14 PST 2008


Lucas,

Nao deveria ser ao contrario ?!

A leitura de um fonte para saber o que o script faz eh errado, pois
consome muito mais tempo, e consequentemente, uma manutencao de rotina
tambem vai consumir. O ideal eh que somente com a documentacao do
script, no comeco de cada funcao e do arquivo, te deem toda a
informacao do que o script faz, e como ele o faz. O comentario vai ser
muito util na hora de alterar uma rotina, porem o excesso dele, no meu
ponto de vista, atrapalha.

um abraco,

-- 
 | --
 | Otávio Fernandes < otaviof | gmail | com >
 | FreeBSD 7.0-PRERELEASE && GNU/Linux User: 283.396
 | (( Especial Programação )) http://geekbr.podcastbrasil.com/ -- 0.15
 | --


Mais detalhes sobre a lista de discussão SaoPaulo-pm