Examples are the best documentation

Similarly, unix man pages desperately need examples. They are almost without fail written as an exhaustive reference for someone who already knows how to use the tool, which is a totally valid use case. But that means they're generally useless for someone trying to use a tool for the first time. Good documentation needs to have both.

Totally agree but there is tldr for that.

I learned recently that tldr also has separate pages for subcommands.