[Feature] Add all possible `--no-` toggle to the man pages / help text for a command, e.g. `yarn install --no-immutable` exists but isn't mentioned anywhere in `yarn install -h`

[k0pernikus]

• [] I'd be willing to implement this feature (contributing guide)
• This feature is important to have in this repository; a contrib plugin wouldn't do

Describe the user story

I as a developer was surprised I could toggle feature off by prefixing them with --no-. I did not see that in the docs.

I looked into yarn install -h, yet there is no reference for any --no- flag, like --no-immutable even though it exists and works.

I stumbled over the flag per acciedent by reading about it in this comment:

You can pass the --no-immutable flag to turn it off for the install command
yarn install --no-immutable

Describe the solution you'd like

I want yarn help text to also include all possible --no- variants.

If this is default feature, I want to be made aware (though unsure what the correct place would be). Also I am unsure if there are some flags that don't support a --no--prefix or where it won't make sense.

[arcanis]

This isn't a feature of Yarn per se, it's a feature of Clipanion, our CLI framework.

[k0pernikus]

This isn't a feature of Yarn per se, it's a feature of Clipanion, our CLI framework.

Thanks for the pointer.

The user story shifts to:

I, as a user of yarn, am not aware of its dependencies nor should I be expected to know of their features. While clipaniom offers the --no--toggles implicitly, yarn should document all its features explicitly in its man pages.

If a flag (or even if all flags) allow for a --no-variant they should be listed and explained in the help text at best, but also only indicating that a flag can be inversed by prefixing --no- would make yarn much more straight forward to use.

[yarnbot]

Hi! 👋

It seems like this issue as been marked as probably resolved, or missing important information blocking its progression. As a result, it'll be closed in a few days unless a maintainer explicitly vouches for it.