La documentación oficial de Java, conocida como JavaDoc, es el compendio más completo de las clases, interfaces y métodos de la plataforma Java. Se accede en línea desde el sitio de Oracle, pero también puedes descargarla para consultarla offline o usar herramientas como https://www.javadoc.io/ o visores como Zeal/Dash.
¿Por qué profundizar en JavaDoc? Descubrimiento de APIs: Más allá de ArrayList, encontrarás paquetes como java.nio, java.time, java.util.concurrent, ¡y muchos más!, con ejemplos de uso claros.
Comprensión de contratos: Cada método documenta precondiciones (@throws), valores de retorno (@return) y comportamientos esperados.
Evitar sorpresas: Saber si un método es thread-safe, o si lanza una excepción checked, salva horas de depuración.