1. I would spend an hour and stub out a basic POD template that fits your needs. If this is for personal use, and not for use at work, skip to step 3.
  2. Send out POD template to co-workers, take their feedback, re-work. Rinse, later, repeat until you get their sign-off. (NOTE: this step may be impossible to complete, as you cannot cater to everyone. So in my book, majority (or the boss ;-) rules in this type of scenario)
  3. Save this template somewhere, preferably in a source control system.
  4. Set the template up as a macro in <insert editor here>
  5. Whenever starting a new script or module, you can run the macro and it gives you the core POD documentation you need with things like author and copyright filled in.

    At this point you have a re-usable template that fits your (or your team's) needs. For example, my team has a section for On-call support on what return-codes mean and another about whether a job is re-runnable or needs to have things staged (and what they are) to be re-run. This makes the on-call support's team's lives easier when they are awoken at 3am to fix a broken script.

    In reply to Re: pod stub from module by etm117
    in thread pod stub from module by arcnon

    Title:
    Use:  <p> text here (a paragraph) </p>
    and:  <code> code here </code>
    to format your post, it's "PerlMonks-approved HTML":


  6. Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  7. Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  8. Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  9. Please read these before you post! —
  10. Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  11. You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  12. Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  13. See Writeup Formatting Tips and other pages linked from there for more info.