Hacker News new | ask | show | jobs
by nonrandomstring 1001 days ago
Tangential, but see:

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.