Hillel Wayne personal blog
Maybe comments should explain 'what' (2017)
People say “Comments should explain why, not what.” I feel like starting a flame war today so I’m going to argue that comments should explain ‘what’ too. Please don’t use this as justification to write bad code, okay? Okay. First of all, why shouldn’t comments explain ‘what’? If you need comments to explain what’s…
- Points
- 205
- HN comments
- 202
- Submissions
- 1
- Cited by
- 0 commenters
Software EngineeringLife, Learning & Writing2026
On Hacker News
| Submitted | Title on HN | Points | Comments |
|---|---|---|---|
| Jan 4, 2026 | Maybe comments should explain 'what' (2017) by zahrevsky | 205 | 202 |
