I like the idea (++) and have even used the idea myself in the past in the Tk::JComboBox docs, and plan to implement it within other modules I publish and/or maintain. However, I disagree that Perlmonks should be where this information is kept. It should be in the docs. Barring that, I think AnnoCPAN is the best place for others to add this information. AnnoCPAN provides a mechanism that can provide feedback to module authors, and even if authors don't add it, the annotations remain "close" to the documents through the service.

If you're looking for something to place on Perlmonks, I think maybe a longer tutorial or article (similar to the survey you mentioned) that goes into more depth might be worthwhile

Rob

In reply to Re: A CPAN related modules section by rcseege
in thread A CPAN related modules section by metaperl

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.