http://shop.oreilly.com/product/9780596001735.do chapter 7.

Don't focus on the Perl language, just on their best practices for documentation. the guideline in terms of content are totally relevant for any language/developers and polished by practice.

Even if I chose to switch from Perl to python, I still miss Perl in terms of module distribution/testing/documentation.

Perl, and Perl community, I miss you, and I value what you learnt me :)

I advocate for people to be open minded and take good ideas without prejudice on their origins.