General Guidelines when it comes to using comments

---

These sections are based on the book "Code Complete 2", Chapter 32, Self-Documenting code

---

• Comment Arguments Pro & Con
• Types of Comments trivial, explaination, marker, summary, intent, meta-comments
• General Tips on Comments
• Commenting Individual Lines
• Commenting Paragraphs of Code
• Commenting Data Declarations
• Commenting Control Structures
• Commenting Routines
• Commenting Classes
• Commenting Files
• Commenting Programs

-- ShawnDB - 16 Jun 2008