Re:We fired our top talent. Best decision we ever made
by scintill76 on Monday October 16, 2017 @04:21PM
(#15486348)
Reminds me of this style:
Such comments are worthless noise that obscures the important parts of the code and camouflages any actual useful comments that might be there. I would so much rather have better names than "thing", "foo", and "bar", and maybe a comment about why the values are summed, if it's not obvious. When you do those right, you won't even need many comments. Maybe a docblock, but don't bother with that if it's nothing more than a robotic "English version" of what is already obvious from the function definition. IMO most good developers will perceive your file header as a redundant annoyance for similar reasons, as other commentors have explained.
[ Parent
| on HN ]
Re:We fired our top talent. Best decision we ever made
by pc86 on Wednesday October 18, 2017 @01:36PM
(#15501139)
It's the "CS 050 Computer Science for Humanities Majors" type of commenting (I was a humanities major, no offense intended). A bunch of comments that are only there because you think you have to have comments, or because you're graded on whether or not comments exist.