Personally, I have always believed that comments are far more important than any other kind of documentation, on the basis that they are more likely to be kept up to date.
Personally, I have always believed that comments are far more important than any other kind of documentation, on the basis that they are more likely to be kept up to date.