De gustibus non est disputandum.
I've found javadocs enormously helpful when I was learning Java 20 years ago. But then again, I also like man pages and use them a lot.
If I'm looking for option "-e" of the test command, here's what I would do:
$ man test
and then "/-e". Searching within a document is a commonly required skill in so many situations that I don't even think twice when applying it in man pages.Of course, you could also just define a bash function for the functionality you're after like so:
mano() {
man "$1" | grep -A1 -- "$2"
}
and then do $ mano test -e
or something along those lines.