pulumi*: add option placeholders (#16444)

pages/common/pulumi-about.md

@@ -9,12 +9,12 @@
 
 - Print information about the Pulumi environment in JSON format:
 
-`pulumi about --json`
+`pulumi about {{[-j|--json]}}`
 
 - Print information about the Pulumi environment of a specific stack:
 
-`pulumi about --stack {{stack_name}}`
+`pulumi about {{[-s|--stack]}} {{stack_name}}`
 
 - Display help:
 
-`pulumi about --help`
+`pulumi about {{[-h|--help]}}`

pages/common/pulumi-cancel.md

@@ -9,8 +9,8 @@
 
 - Skip confirmation prompts, and proceed with cancellation anyway:
 
-`pulumi cancel --yes`
+`pulumi cancel {{[-y|--yes]}}`
 
 - Display help:
 
-`pulumi cancel --help`
+`pulumi cancel {{[-h|--help]}}`

pages/common/pulumi-config.md

@@ -5,11 +5,11 @@
 
 - View current configuration in JSON format:
 
-`pulumi config --json`
+`pulumi config {{[-j|--json]}}`
 
 - View configuration for a specified stack:
 
-`pulumi config --stack {{stack_name}}`
+`pulumi config {{[-s|--stack]}} {{stack_name}}`
 
 - Get the value of a configuration key:
 

pages/common/pulumi-destroy.md

@@ -9,11 +9,11 @@
 
 - Destroy all resources in a specific stack:
 
-`pulumi destroy --stack {{stack}}`
+`pulumi destroy {{[-s|--stack]}} {{stack}}`
 
 - Automatically approve and destroy resources after previewing:
 
-`pulumi destroy --yes`
+`pulumi destroy {{[-y|--yes]}}`
 
 - Exclude protected resources from being destroyed:
 

pages/common/pulumi-env.md

@@ -29,4 +29,4 @@
 
 - Display help:
 
-`pulumi env --help`
+`pulumi env {{[-h|--help]}}`

pages/common/pulumi-new.md

@@ -21,4 +21,4 @@
 
 - Use the specified secrets provider with the <pulumi.com> backend:
 
-`pulumi new --secrets-provider={{passphrase}}`
+`pulumi new --secrets-provider {{passphrase}}`

pages/common/pulumi-preview.md

@@ -9,7 +9,7 @@
 
 - Show a preview of updates to a stack's resources in JSON format:
 
-`pulumi preview --json`
+`pulumi preview {{[-j|--json]}}`
 
 - Preview updates as a rich diff showing overall changes:
 
@@ -17,4 +17,4 @@
 
 - Display help:
 
-`pulumi preview --help`
+`pulumi preview {{[-h|--help]}}`

pages/common/pulumi-refresh.md

@@ -21,8 +21,8 @@
 
 - The name of the stack to operate on (defaults to the current stack):
 
-`pulumi refresh --stack {{stack_name}}`
+`pulumi refresh {{[-s|--stack]}} {{stack_name}}`
 
 - Display help:
 
-`pulumi refresh --help`
+`pulumi refresh {{[-h|--help]}}`

pages/common/pulumi-stack.md

@@ -9,7 +9,7 @@
 
 - Show the stack state along with resource URNs:
 
-`pulumi stack --show-urns`
+`pulumi stack {{[-u|--show-urns]}}`
 
 - List stacks in the current project:
 
@@ -17,7 +17,7 @@
 
 - List stacks across all projects:
 
-`pulumi stack ls --all`
+`pulumi stack ls {{[-a|--all]}}`
 
 - Select an active stack:
 

pages/common/pulumi-state.md

@@ -25,4 +25,4 @@
 
 - Display help:
 
-`pulumi state --help`
+`pulumi state {{[-h|--help]}}`

pages/common/pulumi-up.md

@@ -9,11 +9,11 @@
 
 - Automatically approve and perform the update after previewing it:
 
-`pulumi up --yes`
+`pulumi up {{[-y|--yes]}}`
 
 - Preview and deploy changes in a specific stack:
 
-`pulumi up --stack {{stack}}`
+`pulumi up {{[-s|--stack]}} {{stack}}`
 
 - Don't display stack outputs: