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

API docs are not comments. If Java needs them, they should be maintained and up-to-date. Some languages don't need them to such a degree (type signatures in Haskell are damn expressive).

Higher level comments (“comments” is a suitable word here, it's not something your attach just for the sake of it) is a must for a code that does anything remotely complicated/interesting.




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

Search: