coder
diff --git a/‎cli/parameter.go
+1-1 b/‎cli/parameter.go
+1-1
diff --git a/‎cli/testdata/coder_create_--help.golden
+2-1 b/‎cli/testdata/coder_create_--help.golden
+2-1
diff --git a/‎cli/testdata/coder_restart_--help.golden
+2-1 b/‎cli/testdata/coder_restart_--help.golden
+2-1
diff --git a/‎cli/testdata/coder_start_--help.golden
+2-1 b/‎cli/testdata/coder_start_--help.golden
+2-1
diff --git a/‎cli/testdata/coder_update_--help.golden
+2-1 b/‎cli/testdata/coder_update_--help.golden
+2-1
diff --git a/‎docs/reference/cli/create.md
+1-1 b/‎docs/reference/cli/create.md
+1-1
diff --git a/‎docs/reference/cli/restart.md
+1-1 b/‎docs/reference/cli/restart.md
+1-1
diff --git a/‎docs/reference/cli/start.md
+1-1 b/‎docs/reference/cli/start.md
+1-1
diff --git a/‎docs/reference/cli/update.md
+1-1 b/‎docs/reference/cli/update.md
+1-1
@@ -58,7 +58,7 @@ func (wpf *workspaceParameterFlags) cliParameters() []serpent.Option {
 		serpent.Option{
 			Flag:        "rich-parameter-file",
 			Env:         "CODER_RICH_PARAMETER_FILE",
-			Description: "Specify a file path with values for rich parameters defined in the template.",
+			Description: "Specify a file path with values for rich parameters defined in the template. The file should be in YAML format, containing key-value pairs for the parameters.",
 			Value:       serpent.StringOf(&wpf.richParameterFile),
 		},
 	}
 
@@ -28,7 +28,8 @@ OPTIONS:
 
       --rich-parameter-file string, $CODER_RICH_PARAMETER_FILE
           Specify a file path with values for rich parameters defined in the
-          template.
+          template. The file should be in YAML format, containing key-value
+          pairs for the parameters.
 
       --start-at string, $CODER_WORKSPACE_START_AT
           Specify the workspace autostart schedule. Check coder schedule start
 
@@ -24,7 +24,8 @@ OPTIONS:
 
       --rich-parameter-file string, $CODER_RICH_PARAMETER_FILE
           Specify a file path with values for rich parameters defined in the
-          template.
+          template. The file should be in YAML format, containing key-value
+          pairs for the parameters.
 
   -y, --yes bool
           Bypass prompts.
 
@@ -24,7 +24,8 @@ OPTIONS:
 
       --rich-parameter-file string, $CODER_RICH_PARAMETER_FILE
           Specify a file path with values for rich parameters defined in the
-          template.
+          template. The file should be in YAML format, containing key-value
+          pairs for the parameters.
 
   -y, --yes bool
           Bypass prompts.
 
@@ -26,7 +26,8 @@ OPTIONS:
 
       --rich-parameter-file string, $CODER_RICH_PARAMETER_FILE
           Specify a file path with values for rich parameters defined in the
-          template.
+          template. The file should be in YAML format, containing key-value
+          pairs for the parameters.
 
 ———
 Run `coder --help` for a list of global options.
Original file line number	Diff line number	Diff line change
`@@ -58,7 +58,7 @@ func (wpf *workspaceParameterFlags) cliParameters() []serpent.Option {`
`58`	`58`	`serpent.Option{`
`59`	`59`	`Flag: "rich-parameter-file",`
`60`	`60`	`Env: "CODER_RICH_PARAMETER_FILE",`
`61`		`- Description: "Specify a file path with values for rich parameters defined in the template.",`
	`61`	`+ Description: "Specify a file path with values for rich parameters defined in the template. The file should be in YAML format, containing key-value pairs for the parameters.",`
`62`	`62`	`Value: serpent.StringOf(&wpf.richParameterFile),`
`63`	`63`	`},`
`64`	`64`	`}`