I disagree that there are much better ways. When I have a question while I’m working in the terminal, it’s nice to have a searchable manual that’s in the terminal.
But I can certainly understand why modern manpages aren’t well-developed. That info is already somewhere else. And it’s good enough. It’s not like I’m paying people to write manpages.