[inertiatic]

Thinking code can be "self-documenting" is one of the biggest delusions of this field.

[abritinthebay]

You’re being downvoted but it’s extremely true.

Code should strive to be as self-documenting as possible but there will always need to be some level of documentation- and good comments are part of that.

One other part of that effort should be good unit, integration, and acceptance, tests.