I think man pages were once a very powerful tool. It's definitely the way to document a programming environment with all it's tools and libraries.
But now that modern application's man pages are often longer than a full-blown book, I seldom find meaningful documentation inside them.
Because of this and various "standards", i.e. gzipped man pages, html files and other undocumented formats, I have stopped caring and now use today's equivalent of grep to search through dozens of exabytes of data first, and then get all the information I need, but more up-to-date, shorter and easier to read.
Also, now that nobody knows how to read all the different types of manpages anymore, developers have started to simply include all the documentation inside their executables. They now have options called --usage, --full-usage, --short-help, or --long-help. Try to compress that away...