fly: improve help text for fly order-pipelines

[zoetian]

What challenge are you facing?

The help text for fly order-pipelines:

Usage:
  fly [OPTIONS] order-pipelines [order-pipelines-OPTIONS]

Application Options:
  -t, --target=              Concourse target name
  -v, --version              Print the version of Fly and exit
      --verbose              Print API requests and responses
      --print-table-headers  Print table headers even for redirected output

Help Options:
  -h, --help                 Show this help message

[order-pipelines command options]
      -p, --pipeline=        Name of pipeline to order

describes the -p flag as Name of pipeline to order, which really makes it seem like you're only supposed to pass this flag once. In fact, if you look at the docs, you see it can be passed multiple times. It would be great if I could learn this from the help text, rather than needing to refer to the docs site.

What would make this better?

Something as simple as

[order-pipelines command options]
      -p, --pipeline=        Name of pipeline to order - this flag can be passed multiple times

The copy could probably be better than that example, but you get the idea.

Are you interested in implementing this yourself?

👍