[cosmotic]

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.