質問
私を見つけることができました。ページからサファリの書籍のオンラインを提供する テンプレート, ものを記述ポッドのコメントなんなのかどのように良いのか、であれば足りるものに利用することも考えられる条約が含まれています。
その条約に従う場合書面にポッドのコメントのためのPerlスクリプト?があるように 日Javadoc条約, が、ポッドのコメント?
解決
これは精巧ではないのですが、私はJuerdの perlpodtut の導入多くのことを好き。
著者は、彼が共通のセクションとそれらが含まれるであろうと考えるもの言及します。
他のヒント
Perlのベストプラクティスでの推奨事項のセットがあります。第7章の全体は、それはまた、CPANの規則について語っPODを使用して、ドキュメントをカバーし、そしてなどのモジュール、大規模プロジェクトのドキュメントへの最良のアプローチ。それはおそらくあなたの最善の策です。
あなたは CPAN検索するにPerlモジュールのためのポッドを見て、すぐに誰もが行うことに事を注意することができます。ツールはあなたのための定型文を作り始め、様々なモジュールます。
それはあなたがガイドラインを買ってあげると同じくらい近いです。
所属していません StackOverflow