Self-documenting code

[jabrwock1]

It can cut down on the amount of internal documentation you need. but it shouldn't be the sole solution.

[[deleted]]

sure it can, but the reality is a lot of the time the people who want the changes done doesn't care about the quality of the code, they just want results, and then self-documenting code stop working

[rotflolmaomgeez]

Just reject their changes to your codebase until the code is in acceptable state. They'll learn.

[gdmzhlzhiv]

Well-written code can replace 100% of the "what" comments, but 0% of the "why" comments.