Stiamo parlando di documentazione, giusto?
Perche' concettualmente non e' di nessun interessa sapere come lo fa, ma serve sapere solo esattamente che cosa fa (e quindi non sommariamente).
E' detto information hiding ed e' uno dei concetti fondamentali della programmazione: un programma complesso lo scomponi in tanti piccoli mattoncini concentrandoti di volta in volta nella progettazione di un nuovo mattoncino (per cui ti serve sapere come farlo) usando i mattoncini che hai a disposizione (per i quali ti basta sapere che cosa fanno)
In ogni caso sono disponibili anche i sorgenti di tutte le API e si trovano in un file dal nome src.zip disponibile quando usi il JDK (non il JRE)