Eu prefiro o "Inline POD" :-)<br><br>Ao começar a ver o código você já se depara com a documentação do mesmo, e a documentação dos métodos vem logo antes da declaração dos mesmos... Se eu fosse deixar a doc dos métodos longe deles, eu acabaria deixando eles "fora de sincronia" (ex: adicionando|removendo|renomeando um método|parâmetro e esquecendo de fazer o pod refletir a mudança).
<br><br>Aliás, acabei de ver o post do perlmonks, o primeiro comentário fala justamente isso que eu falei... E eu concordo com outro ponto que o cara menciona: pod é feio pra caramba... <br><br>[]s<br>Wendel<br><br><div class="gmail_quote">
On Jan 10, 2008 11:37 PM, Lucas F. Rosada <<a href="mailto:lucasrosada@gmail.com">lucasrosada@gmail.com</a>> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Olá!<br><br>RTFM para mim! Encontrei esse post no perlmonks que discute aproximadamente o que perguntei: <a href="http://www.perlmonks.org/?node_id=94969" target="_blank">http://www.perlmonks.org/?node_id=94969</a><br>Eles debatem entre o "Inline POD" e o "EOF POD". Dois termos novos para mim ;)
<br><br>De qualquer forma, gostaria de ouvir a opinião dos senhores quanto ao "Inline POD" x "EOF POD" e, além disso, sobre padrões de documentação comumente utilizados.<br><br>Um abraço.<br><font color="#888888">
<br>Lucas</font><div><div></div><br></div></blockquote></div>