How do you know which module is "right" for the task? (or wrong for the task)
It would be nice if module authors included an explanation of why their module is better or worse than other modules that provide the same or similar functionality. Or at the very least highlighted the existence of other modules or approaches.
The best example of this that I've seen is Should I use Date::Manip in the Date::Manip docs.
I tried to do something similar with the
Writing Excel Files section of Spreadsheet::WriteExcel.
See also Rating System for Modules and mirod's suggestion: Module Reviews (again!).