Hacker News new | ask | show | jobs
by caseysoftware 4960 days ago
Those aren't comments, that's someone being lazy.

A comment should describe the why or the goal, not the how.

1 comments

Personally I appreciate good "how" comments for algorithm implementations in C++, where the implementation in code isn't as clear as a (perhaps less efficient) pseudo-code version in the comments. "How" comments are just as valid as "why" comments, and the parent comment illustrates that "copy-comments giving no more information or intuition than the code" are worthless, which is why I don't have comments every 3-7 (not even every 20) lines like the submission suggests.