Note on Why Not Comments via Computer Things

That’s the fundamental problem with self-documenting negative information. “Self-documentation” rides along with written code, and so describes what the code is doing. Negative information is about what the code is not doing.

FROM:

Computer Things

Why Not Comments

Source

It’s important to explain why the code isn’t written another way.