Then by all means, submit a patch to p5p that improves the documentation.

In my experience, the Perl 5 hackers are very open to doc improvements, and haven't rejected any of my doc patches. You really should try it.