Teaching the Next Dev: Why Explaining Your CSS Matters

A CSS comment explaining what a margin does isn't much help. A comment explaining why this particular page needs extra space can save someone a fair amount of head-scratching.

I want the class names to describe the component and the comments to explain the oddities. If I can't explain a rule without walking through three unrelated templates, it's probably time to look at the structure. That's also a good conversation to have with someone learning the codebase: follow one component from the markup to the stylesheet together.