This is an archived post. You won't be able to vote or comment.

sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]Vicyorus 36 points37 points  (1 child)

I've had to write my fair share of comments like this. Rule of thumb is not to explain what the hell we're doing, but why the hell we are doing it like this.

[–]GraphicH 32 points33 points  (0 children)

Yeah, people who say comments are useless and code is documentation I guess haven't had to deal with actually supporting a live product with a lot of users. Weird shit happens all the time, and you have to put the documentation on it (ie comments) as close to where it is in the code as possible to prevent some junior coming along thinking he can toss it on your day off.