I am begging developers of command line tools to simply write an example of the working command after the options.

reading a 1000 lines of documentation with a million -flags and -switches and then guessing how im supposed to use them is not fun. many many non coders want to use your program. Let us copy paste the working command and then edit to our needs

@nix Have you seen https://tldr.sh/ ? I find it indispensable.

Of course you are correct, this should be included in all command line tool documentation by the authors/maintainers, rather than relying on a third party tool to address the problem.

tldr pages

Simplified and community-driven man pages

@skyfaller
This is wonderful, thanks! And there's an #emacs client I'm quickly going to install 😉
@nix @aksharvarma