Bhè, su una cosa penso tutti siano d'accordo, che la sun non si sia mai sprecata (in linea di massima) nel fornire ai programmatori un "manuale" degno di tale nome. Molte delle API più sofisticate però sono ben documentate, e su Swing di roba ce n'è, anche se non di livello altissimo (credo che in giro ci sia un librone della O'Reilly di un migliaio di pagine di solo Swing... ben più fornito dello Swing Tutorial che to ho linkato). Benvenuto nel mondo di java.
Saluti