Documentation Quality

STOP - Documentation Freshness

• Documentation rots faster than code. Stale docs are worse than no docs.
• If code changed, check which docs need updating - README, CLAUDE.md, API docs, comments
• Comments explain WHY, not WHAT - If it repeats the code, delete it

Core Principle

"The purpose of comments is to explain things that aren't obvious from the code." — Ousterhout, APOSD