I truely believe all documentation is already there, it's just their organization, or lack of, that makes it less helpful. This is sort of like the web before google.

It seems you are not aware of perldoc.com

As a user of both Perl and Python I've found that the documentation of Perl's standard distribution is much more user friendly than its Python counterpart. This is most noticeable when it comes to code examples - they are as scarce in the Python docs as they are abundant in the Perl docs.