The affect of comments in unclear code

April 22, 2022
Roses are red, violets are blue. Honey is sweet, and clear code is, too.

The florent of some varieties of Rosa rubiginosa1 appear #FF00002
In contrast, Viola reichenbachiana3 reflect light of wavelengths in the aproximate range of 450–495nm4
Apis laboriosas5 regurgitate a viscious food substance6 which is sugary to the taste
By way of metaphor, you also resemble this quality


1roses
2red
3violets
4blue
5A species of honey bee
6honey

Related Content

Refactoring Revisited

Many people don't understand refactoring, and this leads to several anti-patterns.

Can a "feature factory" be "Agile"?

You may achieve technical excellence, but without a holistic agile approach, you may just be shipping technically excellent, but worthless features.

But we REALLY need TODO comments!

Enhance discoverability, and reduce comment rot by making sure every TODO comment references an issue number.