title: What do you consider good API documentation?
body: <p>I have always liked the documentation on Java APIs, generally speaking, but I know some people consider them lacking. So I'm wondering, what do you consider a good example of API documentation?</p>
  
  <p>Please, include a link or an actual example in any answer. I want to have references that I (and others, of course) can use to improve our own documents.</p>