News for hackers. Stuff that matters.
Re:Doom 3 Source code review by batista on Saturday June 09, 2012 @04:18AM (#4087590)
>At some point it becomes a burden to see the code behind the comments. (And just so no one misinterprets me: I am not against comments /per se/.)

Then use an editor/IDE that can automatically hide or fold the comments?

Re:Doom 3 Source code review by Muzza on Saturday June 09, 2012 @04:25AM (#4087598)
Throwing the baby out with the bath water. I'd much rather have good comments.
Re:Doom 3 Source code review by Confusion on Saturday June 09, 2012 @06:08AM (#4087762)
The problem is that comments are often only good the first few times you read them. After heavily hacking on some code for a while, you know the comments. I find the ability to fold comments very valuable.
Re:Doom 3 Source code review by Retric on Saturday June 09, 2012 @09:33AM (#4088057)
Unfortunately, that tends to lead to vary stale comments which hinders the next developer.
Re:Doom 3 Source code review by Confusion on Saturday June 09, 2012 @12:00PM (#4088365)
Yes, I admit that in code reviews, staleness of comments is a thing that tender to get pointed out to me. However, I've since developed a procedure (review comments belonging to any hunk of changes) to prevent that.