Salve a todos!<br><br>Estive lendo sobre POD e percebi que é boa prática documentar um script ou módulo no estilo de uma man page, no entanto sem deixar para trás cada um dos métodos públicos existentes nele. Porém, nos últimos tempos programei em C e Java, onde é costume comentar uma função ou método logo acima de seu cabeçalho.
<br>Assim, surgiu a dúvida: usar só documentação em POD no fim do módulo, documentar as funções e manter o POD do script em geral (com sinópse, autor, etc.) sem se ater às funções ou manter as duas documentações completas?
<br>Existe algum padrão (ou boas práticas) de documentação de rotinas em perl (contendo informações como descrição, parâmetros de entrada/saída, retorno, etc.)?<br><br>Agradeço a todos da lista.<br><br>Um abraço.<br><br>Lucas.
<br clear="all"><br>-- <br>&quot;O que há aí para mim?&quot;