choco*: add short options (#18015)

pages/windows/choco-apikey.md

@@ -9,12 +9,12 @@
 
 - Display a specific source and its API key:
 
-`choco apikey --source "{{source_url}}"`
+`choco apikey {{[-s|--source]}} "{{source_url}}"`
 
 - Set an API key for a source:
 
-`choco apikey --source "{{source_url}}" --key "{{api_key}}"`
+`choco apikey {{[-s|--source]}} "{{source_url}}" {{[-k|--api-key]}} "{{api_key}}"`
 
 - Remove an API key for a source:
 
-`choco apikey --source "{{source_url}}" --remove`
+`choco apikey {{[-s|--source]}} "{{source_url}}" --remove`

pages/windows/choco-info.md

@@ -9,12 +9,12 @@
 
 - Display information for a local package only:
 
-`choco info {{package}} --local-only`
+`choco info {{package}} {{[-l|--local-only]}}`
 
 - Specify a custom source to receive packages information from:
 
-`choco info {{package}} --source {{source_url|alias}}`
+`choco info {{package}} {{[-s|--source]}} {{source_url|alias}}`
 
 - Provide a username and password for authentication:
 
-`choco info {{package}} --user {{username}} --password {{password}}`
+`choco info {{package}} {{[-u|--user]}} {{username}} {{[-p|--password]}} {{password}}`

pages/windows/choco-list.md

@@ -13,7 +13,7 @@
 
 - Display a list including local programs:
 
-`choco list --include-programs`
+`choco list {{[-i|--include-programs]}}`
 
 - Display only approved packages:
 
@@ -21,7 +21,7 @@
 
 - Specify a custom source to display packages from:
 
-`choco list --source {{source_url|alias}}`
+`choco list {{[-s|--source]}} {{source_url|alias}}`
 
 - Provide a username and password for authentication:
 

pages/windows/choco-new.md

@@ -17,7 +17,7 @@
 
 - Create a new package in a custom output directory:
 
-`choco new {{package}} --output-directory {{path/to/directory}}`
+`choco new {{package}} {{[--out|--output-directory]}} {{path/to/directory}}`
 
 - Create a new package with specific 32-bit and 64-bit installer URLs:
 

pages/windows/choco-pack.md

@@ -13,4 +13,4 @@
 
 - Package a NuGet specification to a specific directory:
 
-`choco pack {{path\to\specification_file}} --output-directory {{path\to\output_directory}}`
+`choco pack {{path\to\specification_file}} {{[--out|--output-directory]}} {{path\to\output_directory}}`

pages/windows/choco-pin.md

@@ -10,12 +10,12 @@
 
 - Pin a package at its current version:
 
-`choco pin add --name {{package}}`
+`choco pin add {{[-n|--name]}} {{package}}`
 
 - Pin a package at a specific version:
 
-`choco pin add --name {{package}} --version {{version}}`
+`choco pin add {{[-n|--name]}} {{package}} --version {{version}}`
 
 - Remove a pin for a specific package:
 
-`choco pin remove --name {{package}}`
+`choco pin remove {{[-n|--name]}} {{package}}`

pages/windows/choco-push.md

@@ -5,8 +5,8 @@
 
 - Push a compiled `nupkg` to the specified feed:
 
-`choco push --source {{https://push.chocolatey.org/}}`
+`choco push {{[-s|--source]}} {{https://push.chocolatey.org/}}`
 
 - Push a compiled `nupkg` to the specified feed with a timeout in seconds (default is 2700):
 
-`choco push --source {{https://push.chocolatey.org/}} --execution-timeout {{500}}`
+`choco push {{[-s|--source]}} {{https://push.chocolatey.org/}} {{[--timeout|--execution-timeout]}} {{500}}`

pages/windows/choco-search.md

@@ -13,16 +13,16 @@
 
 - Only include exact matches in the results:
 
-`choco search {{query}} --exact`
+`choco search {{query}} {{[-e|--exact]}}`
 
 - Confirm all prompts automatically:
 
-`choco search {{query}} --yes`
+`choco search {{query}} {{[-y|--yes]}}`
 
 - Specify a custom source to search for packages in:
 
-`choco search {{query}} --source {{source_url|alias}}`
+`choco search {{query}} {{[-s|--source]}} {{source_url|alias}}`
 
 - Provide a username and password for authentication:
 
-`choco search {{query}} --user {{username}} --password {{password}}`
+`choco search {{query}} {{[-u|--user]}} {{username}} {{[-p|--password]}} {{password}}`

pages/windows/choco-source.md

@@ -9,24 +9,24 @@
 
 - Add a new package source:
 
-`choco source add --name {{name}} --source {{url}}`
+`choco source add {{[-n|--name]}} {{name}} {{[-s|--source]}} {{url}}`
 
 - Add a new package source with credentials:
 
-`choco source add --name {{name}} --source {{url}} --user {{username}} --password {{password}}`
+`choco source add {{[-n|--name]}} {{name}} {{[-s|--source]}} {{url}} {{[-u|--user]}} {{username}} {{[-p|--password]}} {{password}}`
 
 - Add a new package source with a client certificate:
 
-`choco source add --name {{name}} --source {{url}} --cert {{path\to\certificate_file}}`
+`choco source add {{[-n|--name]}} {{name}} {{[-s|--source]}} {{url}} --cert {{path\to\certificate_file}}`
 
 - Enable a package source:
 
-`choco source enable --name {{name}}`
+`choco source enable {{[-n|--name]}} {{name}}`
 
 - Disable a package source:
 
-`choco source disable --name {{name}}`
+`choco source disable {{[-n|--name]}} {{name}}`
 
 - Remove a package source:
 
-`choco source remove --name {{name}}`
+`choco source remove {{[-n|--name]}} {{name}}`

pages/windows/choco.md

@@ -2,7 +2,7 @@
 
 > The Chocolatey package manager.
 > Some subcommands such as `install` have their own usage documentation.
-> More information: <https://chocolatey.org>.
+> More information: <https://docs.chocolatey.org/en-us/choco/commands/>.
 
 - Execute a Chocolatey command:
 
@@ -10,11 +10,11 @@
 
 - Display help:
 
-`choco -?`
+`choco {{[-h|--help]}}`
 
 - Display help for a specific command:
 
-`choco {{command}} -?`
+`choco {{command}} {{[-h|--help]}}`
 
 - Display version: