- Don't write comments that restate what the code already says.
- Comment only the "why" when something isn't obvious: workarounds, counterintuitive decisions, constraints from an external API.
- No section-divider comments like
// --- Helpers ---. - Don't leave comments describing the change you just made.