Imho, fundamentally man pages fail because they're generally a bunch of descriptive front-matter and then an exhaustive list of parameters, when 99% of time use

Imho, fundamentally man pages fail because they're generally a bunch of descriptive front-matter and then an exhaustive list of parameters, when 99% of time users want to do some of the most common actions with this tool and so the first things shown should be explaining how to do common workflows with examples.