Beefy Boxes and Bandwidth Generously Provided by pair Networks
There's more than one way to do things

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.

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 all is quiet...

How do I use this? | Other CB clients
Other Users?
Others studying the Monastery: (6)
As of 2017-12-18 11:28 GMT
Find Nodes?
    Voting Booth?
    What programming language do you hate the most?

    Results (483 votes). Check out past polls.