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

>At some point it becomes a burden to see the code behind the comments. (And just so no one misinterprets me: I am not against comments /per se/.)

Then use an editor/IDE that can automatically hide or fold the comments?



Throwing the baby out with the bath water. I'd much rather have good comments.


The problem is that comments are often only good the first few times you read them. After heavily hacking on some code for a while, you know the comments. I find the ability to fold comments very valuable.


Unfortunately, that tends to lead to vary stale comments which hinders the next developer.


Yes, I admit that in code reviews, staleness of comments is a thing that tender to get pointed out to me. However, I've since developed a procedure (review comments belonging to any hunk of changes) to prevent that.




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

Search: