Tangential, but see: https://news.ycombinator.com/item?id=37583258 https://news.ycombinator.com/item?id=37583258 Explaining "why" is often (revealing) more ab

Tangential, but see: https://news.ycombinator.com/item?id=37583258 https://news.ycombinator.com/item?id=37583258 Explaining "why" is often (revealing) more about how the programmer is thinking at that moment. It reveals hidden or ineffable knowledge about how the coder arrived at that point/design, and may reveal intent not explicit in the code itself. Mismatches between the declarative and imperative have often been where I've found bugs. Especially in my own code when trying to explain it to myself in a comment opens my eyes to an error. Those "why" comments are our stories about our code.