News for hackers. Stuff that matters.
Re:I've never seen a language's style guide recommend avoidi... by nirvdrum on Wednesday July 23, 2014 @07:37AM (#8073776)
Yes. The industry is full of hacks. I don't see how that's a problem with comments though. They're going to write hideous code with or without comments.
Re:I've never seen a language's style guide recommend avoidi... by brazzy on Wednesday July 23, 2014 @07:50AM (#8073822)
The problem is that comments visually bloat the code and make it harder to understand. Bad code with useless comments is worse than bad code with no comments. And that's not even counting comments that are out of date and misleading...
Re:I've never seen a language's style guide recommend avoidi... by nirvdrum on Wednesday July 23, 2014 @08:07AM (#8073876)
And bad code with good comments is more useful than bad code with no comments. It strikes me that replacing "comments" with "tests" in much of our thread would lead to the same outcome. I guess we're just going in circles on this one.
Re:I've never seen a language's style guide recommend avoidi... by dragonwriter on Wednesday July 23, 2014 @11:52AM (#8075000)
> The problem is that comments visually bloat the code and make it harder to understand.

That's a good reason to avoid breaking up logical blocks of code with comments.

Its not a good reason not to comment.

> Bad code with useless comments is worse than bad code with no comments.

That's a good reason to have code review (which includes review of comments) to ensure that there is neither bad code nor useless (including out of date or misleading) comments.