About JDK Java docs: > Those are references, not tutorial. This is a great phras... | Hacker News

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

		throwaway2037 84 days ago \| parent \| context \| favorite \| on: How I, a non-developer, read the tutorial you, a d... About JDK Java docs: `> Those are references, not tutorial.` This is a great phrase. I fully agree with your sentiment. To me, I never read Javadocs in HTML-only form. I always read them in an IDE, along with the library code in question. If anything is unclear from the Javadoc, then read the code (which immediately follows the Javadoc).

maxloh 83 days ago [–]

I also occasionally fall back to the source when the documentation isn't comprehensive enough.

But as library users, we're generally not supposed to have to learn the system from its source, aren't we?

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