http://qs321.pair.com?node_id=592739


in reply to What is code readability?

Not so much a comment on what is readable code (I cuddle my elses - so what do I know :-) but a tip on figuring out when it isn't that I've found very useful over the last few years.

Treat comments as a red flag.

This doesn't mean "don't comment". However every time you want to write a comment think "Is this a sign that the code is unclear? Can I make it more intention revealing without a comment?"