This was really interesting. Man pages are at the same time really useful, while being arcane and frustrating to use. I still never remember is it 'man 1 read' or 'man 2 read' for libc vs the bash 'read' command (checking now 1 is the builtin, 2 is libc). Yes I know about 'man man', but it won't stick in my brain which is which.

They also lack discoverability, I just checked man 1 through 5 of 'open' and 'man 3 open' is a random perl pragma, which is not what I'd expect