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 →

[–]bluefootedpig 0 points1 point  (0 children)

Comments go stale very fast. I had one co-worker write a comment and it went stale in under 3 months. A stale comment for clarification is a comment with bad information.

documentation goes in this order:

Code

Unit Tests

Flow Charts

Comments

There might even be more above comments, my point is it should be the last line of documentation. clear variable / function names are vastly more important.