Many years ago I asked a question on stack exchange about self documenting code. https://softwareengineering.stackexchange.com/questions/51307/self-documenting

Many years ago I asked a question on stack exchange about self documenting code. https://softwareengineering.stackexchange.com/questions/51307/self-documenting-code-vs-commented-code https://softwareengineering.stackexchange.com/questions/5130... I spent many years trying to write my code well enough to not need comments. At the same time I just hit 9 years at my current job and what I’ve come to realise is although the code reads, and makes sense, it sometimes lacks context of why. So for the last few years I’ve been trying to add brief supporting comments to explain /why/ something was done, or how it ends up in a certain state, etc. As a result when I go back to that code week or months later I find adding functionality or fixing bugs much easier. I try not to comment too much or too long unless I really need to.