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?"
|
---|
In Section
Meditations