Beefy Boxes and Bandwidth Generously Provided by pair Networks
No such thing as a small change

Re: Dealing with CPAN reviews

by clp (Friar)
on Aug 21, 2009 at 16:43 UTC ( [id://790408] : note . print w/replies, xml ) Need Help??

in reply to Dealing with CPAN reviews

Thanks for contributing to CPAN, and for asking this question on PerlMonks. I've learned about a few resources from the other responses.

Here are some factors I consider when looking at CPAN.

I look at reviews before choosing a module, and appreciate intelligent comments and responses that help me to choose among several different modules. As stated elsewhere, the review section is often empty.

Your CPAN module includes a significant amount of code and documentation - docs are a plus.

You have been updating it recently, several times in the last few weeks - recent activity is a plus.

You responded to the negative review with a specific comment to one criticism. However, you did not address the second criticism (many dependencies). Your INSTALL note mentions the fact that there are many dependencies. Perhaps you should also mention it in your review comment, so anyone reading the reviews will see the issues raised and your responses.

Another idea is to provide a link from your review comment to the section in your documentation that describes your use of other modules and why you did that (rather than writing a long and detailed review comment that merely repeats data listed elsewhere in the package documentation).

Replies are listed 'Best First'.
Re^2: Dealing with CPAN reviews
by leocharre (Priest) on Aug 25, 2009 at 15:41 UTC
    Man, I gotta tell ya.. If I looked for review before choosing a module.. I would have missed out on a TON of amazing stuff!!! Most important thing for me is the documentation. If it sucks, if it's porrly documented, I make a vommity face and keep looking.. Unfortunately there are some old dinosaurs out there that are so so documented.. like PDF::API2.. which I think is... uck.. just look at the docs.. so sad.. this is such a nice module... :-)