title: Improving Java API documentation?
body: <p>What can I do to improve the docs of the official Java API? Is there some convenient way such a wiki site of javadoc allowing people to edit?</p>
  
  <p>If there is none available, what about some tool/script helping document integration? Something which provides auto-integration of javadoc and custom documents, so I can add contents while keeping sync with new API javadoc?</p>
  
  <p>PS: I'm hoping to improve several parts such as JavaFX and Reflection, both lack examples and the latter contains many stub docs such as <em>Class.getSimpleName() = returns the simple name of class</em>.</p>