Hacker News new | ask | show | jobs
by RandallBrown 5029 days ago
Comments are good for the why, not the how.

I've read far too many comments above functions that simply restate exactly what the code is doing or explain what the stupid abbreviated variables mean.

Comments are a tool that should be used sparingly. They definitely have their place and can be used helpfully. I've found that they're easy to screw up though and I try to avoid them.