Pathologically Eclectic Rubbish Lister | |
PerlMonks |
Re^3: Should I leave behind beautiful code or readable code?by Preceptor (Deacon) |
on Mar 30, 2007 at 10:44 UTC ( [id://607433]=note: print w/replies, xml ) | Need Help?? |
Isn't this the point of comments? I mean, so you can write code, which ... well is almost by definition not natural language, to do something, and then put a comment by it to explain how and why it does it?
I don't care what a line of code does. I do care, that someone's taken the time and effort to document or comment what that bit does, if there's _any question at all_ about whether it's easy to understand or not.
In Section
Meditations
|
|