4 ms·
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
by skybrian 16y ago
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.
- timwiseman 16y agoI 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.