> I have often suggested that every comment represents a failure to make the code self explanatory. Part of why Worse Is Better is that relying on self-discipl

> I have often suggested that every comment represents a failure to make the code self explanatory. Part of why Worse Is Better is that relying on self-discipline and a healthy environment is a risky bet. When code comments are presented as a failure to self-document, they are simply not written, irrespective of the actual clarity of the code. Add some pressure or toxic environment and everyone who's not able to grok your codebase won't complain about it — it is self-documenting! If you don't get it, the problem is on your end.