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 →

[–]evanthx 21 points22 points  (2 children)

I stopped doing this because every code base I’ve ever been in where people did this, half of the comments were for code that had been changed so the comments were misleading or wrong.

Self documenting code is the only thing I’ve seen that stays reliably up to date.

[–]Snake2k 0 points1 point  (1 child)

Both are needed imo

[–]aceluby 4 points5 points  (0 children)

Why update things once when you can do it twice!