Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl Monk, Perl Meditation

Re^2: "Cleverness" from HOP

by chromatic (Archbishop)
on Jun 12, 2009 at 08:15 UTC ( #770858=note: print w/ replies, xml ) Need Help??

in reply to Re: "Cleverness" from HOP
in thread "Cleverness" from HOP

Am I naive in thinking you can write clever code so long as your commenting for it increases exponentially with respect to "unit" increases in cleverness?

Yes; comments are far too often a maintenance burden.

I want the intent of my code to be clear on reading the code itself. Where it's not, I try to rephrase the code for clarity. Where that's not possible, I use a comment to explain the motivation.

Comment on Re^2: "Cleverness" from HOP
Replies are listed 'Best First'.
Re^3: "Cleverness" from HOP
by demerphq (Chancellor) on Jun 14, 2009 at 10:54 UTC

    Agreed. Comments should explain the why. The what should be blindingly obvious from the code.


Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://770858]
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others cooling their heels in the Monastery: (5)
As of 2015-11-26 01:13 GMT
Find Nodes?
    Voting Booth?

    What would be the most significant thing to happen if a rope (or wire) tied the Earth and the Moon together?

    Results (695 votes), past polls