O que realmente é a documentação das API(s) do Java??
O Javadoc é o lugar onde você vai aprender quais classes o Java suporta, que métodos tem nessas classes, o que eles fazem e como devem ser usados.
String por exemplo:
http://java.sun.com/javase/6/docs/api/index.html?java/lang/String.html