Thanks for the updates, Thomas. And now on with the complaining!
Thomas Klausner wrote:
- has_example An optional metric that checks if the author included a dir called 'eg|ex|example(s?)' which in turn includes at least on *.pl
IMO examples in an example directory are a detriment, not a bonus. Any uninstalled documentation in the source directory will likely never been seen by the user (think about a CPAN shell installation) or even if they do see it it will be thrown out with the source tree once the module is installed and thus lost. Examples go in the installed docs or they are lost. Additionally, if you're going to keep this thing around, restricting the examples to .pl files penalizes HTML (Mason or other templating system), POD and module examples. [1] It would be best to just say that the directory contains something. [1] Also people like me who don't like to put a .pl extension onto their Perl executables. You don't run ls.c or cpp.sh. The user does not care and should not know what language their executable is in.