Hard concur. When something might look wrong or misleading to a future reader is exactly the time to comment.