Effective Commenting Strategies

Good comments explain the "why" behind code, not the "what." Use these strategies to write comments that enhance code maintainability without creating maintenance burden.

When to Use

• Adding comments to new code
• Reviewing existing comments for quality
• Establishing team commenting standards
• Optimizing comment density for readability
• Handling performance-sensitive code with comments

Core Principle: Intent Over Repetition