Sometimes the search results from CPAN are pretty confusing to me, and very hard to explain to someone who has not used it before. (Which I'm preparing to do in a few weeks. Let's call it a case of the blind leading the blind... but, I need to explain the software I've written to some employees of a customer.)
I like to use my laptop to view documentation while programming on my other computer (instead of pulling up the local copy on the computer I'm doing the programming on). So, I'll often head over to CPAN to pull up documentation on a module. Today I went over to look at the docs for Test::Harness and started with a search to find the module. (Note that your search results may be different...)
I'm not completely sure, but... it looks like the first one is simply bundled with the POE module. Which kind of makes me wonder... should it really show up in the search?
More importantly, should it show up ahead of the stand alone version?
I thought that perhaps CPAN was ordering by date, but Test::Harness::Straps (which was in the search results) is not listed in date order. So, I'm not exactly sure what order the search results are listed in.
Note that the above was with the "in" dropdown selector in it's default "all" position.
It seems that what I really wanted was to set it to "distributions" or "modules"... I can't really tell the difference, or find documentation explaining what the distinction is.