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.
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.