Add ConfigValues reference topic

Author: paigecalvert

docs/reference/custom-resource-configvalues.mdx

@@ -2,19 +2,71 @@
 
 This topic describes the Replicated KOTS ConfigValues custom resource. ConfigValues is used to provide application-specific configuration values during automated (headless) installations with the CLI.
 
+## Overview
+
+The ConfigValues custom resource lists the user-supplied and default values for each item defined in the Replicated KOTS Config custom resource in the given release.
+
+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).
+
+The following image shows an example of how a config field defined in the Config custom resource in a release is represented in a ConfigValues:
+
+![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 from the Config resource (if applicable) as well as the user-supplied `value`. 
+
 ## Example
 
+The following shows an example of a ConfigValues resource that was generated for an application named SlackerNews:
+
 ```yaml
 apiVersion: kots.io/v1beta1
 kind: ConfigValues
+metadata:
+  creationTimestamp: null
+  name: slackernews
 spec:
   values:
-    text_config_field_name:
-      default: Example default value
-      value: Example user-provided value
-    boolean_config_field_name:
-      default: "0"
-      value: "1"
-    password_config_field_name:
-      valuePlaintext: examplePassword
-```
+    certificate_source:
+      default: generate_internal
+    deploy_postgres:
+      default: "1"
+    node_port_port:
+      default: "443"
+    postgres_external_uri: {}
+    postgres_password:
+      value: 68t0HiPFRtVzR+Qy4LEvIGM7OKk0yaPCdlxVNKNkAq3FYEZHTg0SwsGZNumRXcJhJAl2i5g3jS4=
+    service_type:
+      default: node_port
+    slack_bot_token:
+      value: v6awag8ovTZIKrvU/Rh4PQ==
+    slack_clientid: {}
+    slack_clientsecret:
+      value: v6awag8ovTZIKrvU/Rh4PQ==
+    slack_user_token:
+      value: v6awag8ovTZIKrvU/Rh4PQ==
+    slackernews_admin_user_emails: {}
+    slackernews_domain:
+      value: charming-sanderson.ingress.replicatedcluster.com
+    tls_ca: {}
+    tls_cert: {}
+    tls_key: {}
+status: {}
+```
+
+## values
+
+### [item_name].default
+
+The `default` value that was set for the item in the Config custom resource in the release.
+
+Changing the `default` in the ConfigValues had no affect on the default value for the item. To change the default for an item, you must edit the item in the Config resource.
+
+When providing a ConfigValues to perform a headless installation from the command line, it is not necessary to list the `default` value for each item.
+
+### [item_name].value
+
+The user-supplied value for the item. This corresponds to the value supplied by the user in the Admin Console config screen.
+
+To perform an automated or headless install from the command line, users must provide a ConfigValues with a `value` for each required config item.

sidebars.js

@@ -389,6 +389,7 @@ const sidebars = {
                 'reference/custom-resource-about',
                 'reference/custom-resource-application',
                 'reference/custom-resource-config',
+                'reference/custom-resource-configvalues',
                 'reference/custom-resource-helmchart-v2',
                 'reference/custom-resource-helmchart',
                 'reference/custom-resource-lintconfig',