can't see a clear way to show all available options for gh repo create <name> -l <license>

[devhindo]

provide a list of available options for things like --gitignore or --license

example:
gh repo create --license -l

mit
etc.

gh repo create --gitignore -l

Go
Node

reason: I don't know whether it's Go or go and I don't find other way than trying until it works
also mit or MIT? what if I wanted to check if new licenses are getting added?
also idk if this is the best syntax for listing these options or not. knowing that it's not available on the docs

[andyfeller]

@devhindo : As these options are governed beyond gh by GitHub API endpoint in github/gitignore and choosealicense.com, I think its fair we should at least have the documentation point the user to refer to these sites for more information.

While this idea of a semi-flag for listing options is interesting, I don't think it is realistic with how most argument and flag parsing libraries work. Again, the GitHub CLI doesn't govern what is a valid value.

[devhindo]

@andyfeller So, Can't we just provide a CLI option to make a GET request to these external APIs to list the available flag options? If not, We could provide these links in the docs under each flag to be more clear (as the docs were the first place I headed to when I couldn't enter a valid license and found nothing there). I also can't find the code for the mentioned documentation page where I can contribute and add the links you provided.

[babakks]

@devhindo You can find the documentation for gh repo create command here.

[devhindo]

@babakks Okay so that's fetched directly in the docs website here?
@andyfeller A PR that enhances the description of the -g and -l flags to include where the options can be found would be appropriate?

[babakks]

@devhindo I think what you see in the CLI manual website you mentioned above is actually generated from the code (@andyfeller please correct if I'm wrong). So if you update the docs in the code, then both the the CLI manual website and the gh repo create --help output will be updated, in the next release.