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 One thing PowerShell got right is that there's a standard Examples section in the help pages for commands and you can just do e.g. 'man ls -examples' to bring them up.
@pervognsen @nix powershell’s get-help functionality is amazing and something you can add to literally any script with ease.