If I find a Perl module's documentation obscure (either it's 'sparse' or I am), I may google something like the following:

"use Data::Dumper" examples
[download]

Although I think the documentation for Data::Dumper is fine, I've encountered a lot of documentation that's not well written--in my opinion, of course.

Writing good documentation is a skill that's separate and distinct from programming skills, and it requires that a programmer shift into being a teacher. Being a seasoned programmer doesn't mean being a good teacher.