I've only seen limited modules with really poor documentation. Let's, for example, take a look at HTML::TableExtract (yeah, table example ;)

The module clearly is made for a specific goal, to extract data from HTML tables. The POD explains step by step how to set it up. Just like IKEA tables (although I appreciate the quality of HTML::TableExtract more than IKEA tables ;).

IMHO, it'd be quite useless to just put up a ready made script (table) there that will grab info from some website. The POD is like the IKEA manuals, it'll help you set it all up.

I wouldn't miss a night's sleep if CPAN decided to drop the handful of scripts the currently host. There are other sites for that. I firmly believe the Matt's (insert useful thingy here) script days are over. Ready made scripts hardly ever fit in real situations and thus usually need tweaking anyway. Might as well start from scratch. Sourceforge and the before mentioned Hotscripts are better suited places, in my opinion.

--
b10m

All code is usually tested, but rarely trusted.

In reply to Re: Distribution of Program and/or Module by b10m
in thread Distribution of Program and/or Module by pboin

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


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • 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
  • 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;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.