HNGlance

Top Best New Show

Coding Without Comments (2008)

https://blog.codinghorror.com/coding-without-comments/

by alexpadula • 7 months ago

1 2 7 months ago

BL

blog.codinghorror.com

Related Stories

Loading related stories...

Comments

2

runtimepanic• 7 months ago

I’ve always felt this argument works best in small, stable codebases with low team churn. Self-documenting code is a great goal, but in real systems the why often matters more than the what, and that context rarely survives in variable names alone. In my experience, comments age badly when they restate code, but they age quite well when they capture constraints, trade-offs, or historical decisions. The real smell isn’t comments, it’s comments compensating for unclear design.

alexpadula• 7 months ago

Love it! I agree. A large codebase, complex I feel like we don’t want less or no comments, we don’t want useless comments but comments that are up to date and useful to the reader. Sure you can follow code but code can stink too.

Source preview

blog.codinghorror.com

HNGlance

© 2024-2026 HN Glance. Story content belongs to its original sources.

Privacy
Terms