Beefy Boxes and Bandwidth Generously Provided by pair Networks
Do you know where your variables are?

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 the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others having an uproarious good time at the Monastery: (3)
As of 2016-06-30 05:42 GMT
Find Nodes?
    Voting Booth?
    My preferred method of making French fries (chips) is in a ...

    Results (389 votes). Check out past polls.