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

targetsmart has asked for the wisdom of the Perl Monks concerning the following question:

Why most of the CPAN/core modules lacks comments(definitely it has man pages)?. Any particular reason for it.
The reason for asking this question is, as and when I use a subroutine from an external module(can be core module or downloaded from CPAN), I would go and see how the subroutine was implemented in the code by the author, to get to know the good/efficient practices, but many a times because of lack of comments I have gone to other modes like using a debugger, copying only that subroutine and putting some debug messages to it, etc. It would be excellent if it comes with sufficient comments(from a learner point of view).
I believe that I have asked nothing wrong here.

Vivek
-- In accordance with the prarabdha of each, the One whose function it is to ordain makes each to act. What will not happen will never happen, whatever effort one may put forth. And what will happen will not fail to happen, however much one may seek to prevent it. This is certain. The part of wisdom therefore is to stay quiet.