DEV Community

Discussion on: Self Documenting code isn't

Collapse
 
wa1gon profile image
Darryl Wagoner • Edited

I have to tell you that when I read the title, I was on the defensive. That was short live when I got to saying comments should tell "Why" not what.

Telling why keeps the next guy from removing/changing code that looks unneeded or unclear to the reason it is there.

Good job!