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

Kernigan is absolutely right here btw.

There are so many problems with trying to make up for unclear code in comments, that's a real losing battle. I recognize that it may be worth breaking that rule sometimes, but then it is worth noting that, and flagging it so that other programmers can see and fix it. A comment like "#FIXME: This code is unclear: What it does is...." is perfectly acceptable.

Comments are for collaboration. You do NOT want to make them even appear useful for debugging.



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

Search: