|Just another Perl shrine|
The art of comments: (rave from the grave)by BrowserUk (Pope)
|on Jul 07, 2005 at 01:47 UTC||Need Help??|
Update: No more input requested.
Rather than rehash the debate about what makes for good and bad commenting, I wonder if anyone would care to link to one or two examples of what they consider to be "good commenting". Prefereably Perl to keep it on topic, but an one or two particularly good examples of other languages might make for an interesting comparison.
A (few) remarks about why you think that the example you link is good would be interesting also, but it's not a requirement.
Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
Lingua non convalesco, consenesco et abolesco. -- Rule 1 has a caveat! -- Who broke the cabal?
"Science is about questioning the status quo. Questioning authority".
The "good enough" maybe good enough for the now, and perfection maybe unobtainable, but that should not preclude us from striving for perfection, when time, circumstance or desire allow.