Eu acho mais interessante o "EOF POD" como mencionado eu tbm concordo que POD eh feião, e o "Inline POD" acaba atrapalhando a leitura do código. Além do POD utilizo bastante comentário, se outra pessoa quiser saber mais que leia o POD. Particularmente acho assim mais interessante e um código mais limpo pra ler.
<br><br><br><br><div><span class="gmail_quote">Em 11/01/08, <b class="gmail_sendername">Wendel Scardua</b> <<a href="mailto:wendelscardua@gmail.com">wendelscardua@gmail.com</a>> escreveu:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
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><span class="sg">Wendel
</span><div><span class="e" id="q_1176839dd36ac9d6_2"><br><br><div class="gmail_quote">
On Jan 10, 2008 11:37 PM, Lucas F. Rosada <<a href="mailto:lucasrosada@gmail.com" target="_blank" onclick="return top.js.OpenExtLink(window,event,this)">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" onclick="return top.js.OpenExtLink(window,event,this)">
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>
</span></div><br>_______________________________________________<br>SaoPaulo-pm mailing list<br><a onclick="return top.js.OpenExtLink(window,event,this)" href="mailto:SaoPaulo-pm@pm.org">SaoPaulo-pm@pm.org</a><br><a onclick="return top.js.OpenExtLink(window,event,this)" href="http://mail.pm.org/mailman/listinfo/saopaulo-pm" target="_blank">
http://mail.pm.org/mailman/listinfo/saopaulo-pm</a><br></blockquote></div><br>