Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> Good comments tend to not be redundant, they tend to tell you "why" information and be written at the level of intent rather than at the level of implementation. And thus they don't need to be continually updated when the implementation changes.

This. The exception being when things have to get messy for reasons of performance or other non-obvious constraints- at which point, the comments should document why it's messy, but may also provide some guidance around the messy code.



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: