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.

    ---
    $world=~s/war/peace/g