Commenting Data Declarations Comment the units of numeric data Comment the range of allowable numeric values Use enumerations instead of magic numbers or magic strings ...
General Guidelines when it comes to using comments These sections are based on the book "Code Complete 2", Chapter 32, Self-Documenting code Arguments Pro Con of ...