Merge pull request #4039 from replicatedhq/deemphasize-kots-in-ref--material-2

paigecalvert · web-flow · commit 3ae48a71e2d4 · 2026-05-07T14:38:17.000-06:00
Make Config and ConfigValues content work for EC v3
diff --git a/docs/partials/config/_defaultExample.mdx b/docs/partials/config/_defaultExample.mdx
@@ -9,6 +9,6 @@
     value: ""
     default: change me   
 ```
-![Default change me value displayed under the config field](/images/config-default.png)
+<img width="500px" alt="Default change me value displayed under the config field" src="/images/config-default.png"/>
 
 [View a larger version of this image](/images/config-default.png)
diff --git a/docs/partials/config/_helpTextExample.mdx b/docs/partials/config/_helpTextExample.mdx
@@ -7,6 +7,6 @@
     help_text: Check to enable the HTTP listener
     type: bool
 ```
-![Config field with help text underneath](/images/config-help-text.png)
+<img width="500px" alt="Config field with help text underneath" src="/images/config-help-text.png"/>
 
 [View a larger version of this image](/images/config-help-text.png)
diff --git a/docs/partials/config/_property-when.mdx b/docs/partials/config/_property-when.mdx
@@ -1,7 +1,3 @@
-It can be useful to conditionally show or hide fields so that your users are only provided the configuration options that are relevant to them. This helps to reduce user error when configuring the application. Conditional statements in the `when` property can be used to evaluate things like the user's environment, license entitlements, and configuration choices. For example:
-* The Kubernetes distribution of the cluster
-* If the license includes a specific feature entitlement
-* The number of users that the license permits
-* If the user chooses to bring their own external database, rather than using an embedded database offered with the application
+This lets you conditionally show or hide fields so your end customers only see the options that are relevant to them.
 
-You can construct conditional statements in the `when` property using Replicated template functions. Replicated template functions are a set of custom template functions based on the Go text/template library. For more information, see [About Replicated Template Functions](/reference/template-functions-about).
+You can use Go template functions to create conditional statements. Replicated provides a set of Go template functions that you can use to evaluate conditions like the user's environment, their license entitlements, and their previous configuration choices. For more information, see [About Replicated Template Functions](/reference/template-functions-about).
diff --git a/docs/partials/config/_randomStringNote.mdx b/docs/partials/config/_randomStringNote.mdx
@@ -1,3 +1 @@
-:::note
-When you assign a template function that generates a value to a `value` property, you can use the `readonly` and `hidden` properties to define whether or not the generated value is ephemeral or persistent between changes to the configuration settings for the application. For more information, see [RandomString](template-functions-static-context#randomstring) in _Static Context_.
-:::
+When you assign a template function that generates a value to a `value` property, you can use the `readonly` and `hidden` properties to define whether or not the generated value is ephemeral or persistent between changes to the configuration settings for the application. For more information, see [RandomString](template-functions-static-context#randomstring) in _Static Context_.
diff --git a/docs/partials/config/_readonlyExample.mdx b/docs/partials/config/_readonlyExample.mdx
@@ -10,6 +10,6 @@
   value: "{{repl RandomString 20}}"
   readonly: true    
 ```
-![Default change me value displayed under the config field](/images/config-readonly.png)
+<img width="500px" alt="Default change me value displayed under the config field" src="/images/config-readonly.png"/>
 
 [View a larger version of this image](/images/config-readonly.png)
diff --git a/docs/partials/config/_recommendedExample.mdx b/docs/partials/config/_recommendedExample.mdx
@@ -5,6 +5,6 @@
   default: "0"
   recommended: true
 ```
-![config field with green recommended tag](/images/config-recommended-item.png)
+<img width="500px" alt="config field with green recommended tag" src="/images/config-recommended-item.png"/>
 
 [View a larger version of this image](/images/config-recommended-item.png)
diff --git a/docs/partials/config/_requiredExample.mdx b/docs/partials/config/_requiredExample.mdx
@@ -10,6 +10,6 @@
         default: change me
         required: true
 ```
-![config field with yellow required tag](/images/config-required-item.png)
+<img width="500px" alt="config field with yellow required tag" src="/images/config-required-item.png"/>
 
 [View a larger version of this image](/images/config-required-item.png)
diff --git a/docs/partials/config/_typeExample.mdx b/docs/partials/config/_typeExample.mdx
@@ -7,6 +7,6 @@
     type: bool
     default: "0"
 ```  
-![field named HTTP Enabled with disabled checkbox](/images/config-screen-bool.png)
+<img width="500px" alt="field named HTTP Enabled with disabled checkbox" src="/images/config-screen-bool.png"/>
 
 [View a larger version of this image](/images/config-screen-bool.png)
diff --git a/docs/partials/config/_valueExample.mdx b/docs/partials/config/_valueExample.mdx
@@ -8,6 +8,6 @@
     type: text
     value: "{{repl RandomString 20}}"
 ```
-![config field with random string as HTML input](/images/config-value-randomstring.png)
+<img width="500px" alt="config field with random string as HTML input" src="/images/config-value-randomstring.png"/>
 
 [View a larger version of this image](/images/config-value-randomstring.png)
diff --git a/docs/partials/config/_when-requirements.mdx b/docs/partials/config/_when-requirements.mdx
@@ -1,6 +1,4 @@
 * The `when` property accepts the following types of values:
      * Booleans
      * Strings that match "true", "True", "false", or "False"
-    
-    [Replicated template functions](/reference/template-functions-about) can be used to render these supported value types.
 * For the `when` property to evaluate to true, the values compared in the conditional statement must match exactly without quotes
diff --git a/docs/partials/config/_whenExample.mdx b/docs/partials/config/_whenExample.mdx
@@ -21,10 +21,10 @@
     when: repl{{ (ConfigOptionEquals "db_type" "external")}}
 ```
 
-<img alt="External option selected and conditional fields displayed" src="/images/config-when-enabled.png" width="500px"/>
+<img width="500px" alt="External option selected and conditional fields displayed" src="/images/config-when-enabled.png"/>
 
 [View a larger version of this image](/images/config-when-enabled.png)
 
-<img alt="Embedded DB option selected and no additional fields displayed" src="/images/config-when-disabled.png" width="500px"/>
+<img width="500px" alt="Embedded DB option selected and no additional fields displayed" src="/images/config-when-disabled.png"/>
 
 [View a larger version of this image](/images/config-when-disabled.png)
diff --git a/docs/partials/configValues/_config-values-procedure.mdx b/docs/partials/configValues/_config-values-procedure.mdx
@@ -1,4 +1,4 @@
-During installation, KOTS automatically generates a ConfigValues file and saves the file in a directory called `upstream`. After installation, you can view the generated ConfigValues file in the Admin Console **View files** tab or from the command line by running the `kubectl kots get config` command.
+During installation, KOTS automatically generates a ConfigValues file. Users can download the ConfigValues from the Admin Console **View files** tab or with the [`kots get config`](/reference/kots-cli-get-config) command.
 
 To get the ConfigValues file from an installed application instance:
 
diff --git a/docs/reference/custom-resource-config.mdx b/docs/reference/custom-resource-config.mdx
diff --git a/docs/reference/custom-resource-configvalues.mdx b/docs/reference/custom-resource-configvalues.mdx
diff --git a/static/images/config-screen-example-embedded-postgres.png b/static/images/config-screen-example-embedded-postgres.png
diff --git a/static/images/config-screen-example.png b/static/images/config-screen-example.png
diff --git a/styles/config/vocabularies/ReplicatedTerms/accept.txt b/styles/config/vocabularies/ReplicatedTerms/accept.txt
diff --git a/styles/config/vocabularies/TechJargon/accept.txt b/styles/config/vocabularies/TechJargon/accept.txt

-Original file line number
+Diff line change
@@ @@ -1,3 +1 @@ @@
 -:::note
 -When you assign a template function that generates a value to a `value` property, you can use the `readonly` and `hidden` properties to define whether or not the generated value is ephemeral or persistent between changes to the configuration settings for the application. For more information, see [RandomString](template-functions-static-context#randomstring) in _Static Context_.
 -:::
 +When you assign a template function that generates a value to a `value` property, you can use the `readonly` and `hidden` properties to define whether or not the generated value is ephemeral or persistent between changes to the configuration settings for the application. For more information, see [RandomString](template-functions-static-context#randomstring) in _Static Context_.