feat(complete): Add descriptions to dynamic Zsh completions

[vivienm]

When using unstable-dynamic completions in Zsh, suggested values are not described. It's a step backwards compared to the default behavior and it makes things more difficult for users.

I had a quick look and it seems relatively easy to fix. But I'm not familiar with either clap or Zsh autocompletion, so I may miss something here.

[vivienm]

Also, I had to add this to my zshrc to prevent zsh from changing the order of suggestions:

zstyle ':completion:*:*:my-program:*:*' sort false

Not necessarily a problem, but it could be worth documenting, or maybe write it in the completion script?

[epage]

Not necessarily a problem, but it could be worth documenting, or maybe write it in the completion script?

We generally want things sorted according to our order. We tweaked bash to ensure this. If you know how to do insert this in our script to be respected, please help us out and post a PR for this!

[vivienm]

We generally want things sorted according to our order. We tweaked bash to ensure this. If you know how to do insert this in our script to be respected, please help us out and post a PR for this!

I'll give it a try! (Not in this PR.)

[epage]

FYI the issue for zsh sorting is #5752

[epage]

FYI I would classify this as a feat rather than a chore. I see chores as something not relevant for changelogs (and cargo release changes might even hide them, I can't remeber)