add requirements for configvalues

Author: paigecalvert

docs/partials/configValues/_configValuesExample.mdx

@@ -3,11 +3,14 @@ apiVersion: kots.io/v1beta1
 kind: ConfigValues
 spec:
   values:
-    text_config_field_name:
-      default: Example default value
-      value: Example user-provided value
-    boolean_config_field_name:
+    config_item_name:
+      default: example_default_value
+      value: example_value
+    boolean_config_item_name:
       value: "1"
-    password_config_field_name:
-      valuePlaintext: examplePassword
+    password_config_item_name:
+      valuePlaintext: exampleplaintextpassword
+    select_one_config_item_name:
+      default: default_option_name
+      value: selected_option_name  
 ```

docs/partials/configValues/_requirements.mdx

@@ -0,0 +1,5 @@
+The ConfigValues resource passed to the install command must meet the following requirements:
+* Must be valid YAML
+* Must list all configuration items that are defined in the corresponding Config resource in the release
+* For each item in the Config resource that has a default, the ConfigValues must also list the item's default. Default values are not automatically merged from the Config resource during installation.
+* For any configuration items of type `password`, provide the password in plain text in a `valuePlainText` property rather than in the `value` property. For example, `valuePlainText: somesecretvalue`.

docs/reference/custom-resource-configvalues.mdx

@@ -1,24 +1,30 @@
+import ConfigValuesExample from "../partials/configValues/_configValuesExample.mdx"
+
 # ConfigValues
 
 This topic describes the Replicated KOTS ConfigValues custom resource. ConfigValues is used to provide application configuration values during automated or headless installations with the CLI.
 
 ## Overview
 
-The ConfigValues custom resource lists the user-supplied and default values for each application configuration item defined in the Replicated KOTS Config custom resource in the release. For more information about the Config custom resource, see [Config](custom-resource-config).
+The ConfigValues resource lists the values and defaults set for each application configuration item defined in the Replicated KOTS Config custom resource in the release. For more information about the Config custom resource, see [Config](custom-resource-config).
+
+For each installation, the Admin Console automatically generates a ConfigValues resource and makes it available for download in the **View files** tab.
 
-For each installation, the Admin Console automatically generates a ConfigValues resource and makes it available for download in the **View files** tab. End users can also manually create a ConfigValues resource. For example, users must pass a ConfigValues resource during automated or headless installs from the command line to provide application configuration values to the Admin Console. For more information about performing headless installations, see [Automate Embedded Cluster Installations](/enterprise/installing-embedded-automation) and [Automate Existing Cluster Installations with the KOTS CLI](/enterprise/installing-existing-cluster-automation).
+In automated or headless installs from the command line, end users must pass a ConfigValues resource to the install command to provide application configuration values to the Admin Console. For more information about performing headless installations, see [Automate Embedded Cluster Installations](/enterprise/installing-embedded-automation) and [Automate Existing Cluster Installations with the KOTS CLI](/enterprise/installing-existing-cluster-automation).
 
-The following image shows how a ConfigValues resource is generated based on the items defined in a Config resource:
+The following image shows how application configuration items defined a Config resource are represented in a ConfigValues resource:
 
 ![Config fields mapped from Config resource to ConfigValues resource](/images/configvalues-diagram.png)
 
 [View a larger version of this image](/images/configvalues-diagram.png)
 
-As shown in the image above, the ConfigValues resource `values` key lists each item from the Config resource by its `name`. For each item, the ConfigValues lists the `default` value defined in the Config resource (if applicable) as well as the user-supplied `value`.
+As shown in the image above, the ConfigValues resource `values` key lists each item from the Config resource by its `name`. For each item, the ConfigValues resource lists the user-supplied value as well as the default that was defined in the Config resource (if applicable).
 
-## Examples
+## Example
 
+The following shows an example of a ConfigValues resource that can be provided during automated or headless installation from the command line:
 
+<ConfigValuesExample/>
 
 ## Spec