News for hackers. Stuff that matters.
Re:Types of Comments to Avoid Making when Programming by skybrian on Saturday July 24, 2010 @06:06PM (#1544479)
I partially disagree with #4: it's actually a good idea to cite your sources - certainly a better idea than a lot of the other boilerplate commenting I see. If your only source for a business rule is "conversation with Bob in Sales" then say that.
Re:Types of Comments to Avoid Making when Programming by timwiseman on Sunday July 25, 2010 @01:50AM (#1545053)
I have to agree. One of the main uses for comments is to explain why code is a certain way, and if it is that way because a specific person requested it, then it makes sense to note that.

With that said, it matters what details go into that type of comments. Putting in why a certain analyst asked for a specific change, along with who that analyst was, can be very helpful. Noting what the analyst was wearing the type of coffee he was drinking at the moment are just cluttering things.