Command should print out usage information

[wkoszek]

I've installed a gitlab Gem, but the gitlab help isn't very helpful. I need to read a README.md from this repo to understand how to use it. I think gitlab help should print out a standard UNIX usage information with some examples.

[sotayamashita]

@wkoszek any example?

[NARKOZ]

@wkoszek any example?

I think it should be like in man hub https://github.com/github/hub/blob/70a5493539d7a614449f0d32051e08b0dbc53bc3/share/man/man1/hub.1.ronn

[wkoszek]

@NARKOZ Right. Instead of just listing options, show 20 simple one-liners with explanations on what they do. hub, awk, jq and other commands will give you an idea. Thanks!

[perlun]

Adding to this, it's also unclear how to use the --only and --except flags. Example:

$ gitlab jobs 2 "{scope: ["success"], per_page: 100 }" --except artifacts 
wrong number of arguments (given 4, expected 1..2)

$ gitlab jobs 2 "{scope: ["success"], per_page: 100 }" --only artifacts
wrong number of arguments (given 4, expected 1..2)

(Using v4.18.0 of the gem)