[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