Don’t let your comments ramble on about the past or future.
Don’t have comments describing what a function used to do. That information is in the version control. Instead, the comments should only discuss why the current functionality is the way it is.
Similarly, don’t speculate on the future. You don’t know what the future business requirements will be. (cf. YAGNI)
When you update your code, update the comments as well. Don’t turn the comments into lies.
Today's Card 