http://www.perlmonks.org?node_id=877929


in reply to On comments

I agree.

My rules for commenting (from On Coding Standards and Code Reviews) are:

See also Perl Best Practices, Chapter 7, Documentation, which has some excellent advice on how to document your programs.