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

Comments tend to get outdated quickly as your app grows. If you are not careful with your phrasing you might even introduce misinformation into your app. I'd rather read the code instead of comments.


I love when a docstring saves me from reading code. "Takes parameter x which should be in state s, has side effect e, returns j, throws exception if .." Seeing that in my IDE popup and moving on with all the info I need is so satisfying compared to having to waste my time on an unwanted spelunk. It's also impossible to embed all this in a name that isn't a camelcase paragraph.


I can imagine that this is helpful to some people, but when coding I ignore comments usually. Good docs and code is all I need.




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

Search: