Hacker News new | past | comments | ask | show | jobs | submit login

I have a very strong position against comments. Because they're not checked by compiler, they cannot be trusted. And in the places where coee is frequently changing, these comments often detach from their place and get outdated.

This does not relate to function/class/module level docs though, but it also needs to be frequently checked for correctness.




For the next guy maybe wrong comments are eons better than "no comments, no incorrect comments".

But, ye, writing a mess is job security. I don't blame you.




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

Search: