Java docs are great because they document: * technical details and algorithms used * side effects * runtime and memory usage * inputs that result in undefined b

Java docs are great because they document: * technical details and algorithms used * side effects * runtime and memory usage * inputs that result in undefined behavior * causes of exceptions * behavior when accessed concurrently * thoroughly hyperlinked It's been this way for decades and the presentstion has remained largely consistent the whole time.