in reply to Where's a good place to post caveats or "I just got burned by..."
In the case of File::Find maybe the best thing to do would be to attack the documentation with a vengeance and get in touch with the maintainer of the package with updates/suggestions. This way the whole Perl community can benefit.