kots intro edits

Author: paigecalvert

docs/intro-kots.md

@@ -7,7 +7,7 @@ displayed_sidebar: kots
 This topic provides an introduction to the Replicated KOTS installer, including information about KOTS features, installation options, and user interfaces.
 
 :::note
-You must have the Replicated KOTS entitlement to use KOTS. For more information, see [Pricing](https://www.replicated.com/pricing) on the Replicated website.
+The Replicated KOTS entitlement is required to install applications with KOTS. For more information, see [Pricing](https://www.replicated.com/pricing) on the Replicated website.
 :::
 
 ## Overview
@@ -19,8 +19,8 @@ KOTS communicates securely with the Replicated vendor platform to synchronize cu
 Installing an application with KOTS provides access to feautures such as:
 
 * Support for air gap installations
-* Support for installations onto VMs or bare metal servers
-* The KOTS admin console, which provides a user interface where your customers can install and manage their application instance
+* Support for installations on VMs or bare metal servers
+* The KOTS admin console, which provides a user interface where customers can install and manage their application instances
 * Instance telemetry automatically sent to the vendor portal for instances running in customer environments
 * Strict preflight checks that block installation if environment requirements are not met
 * Backup and restore with Replicated snapshots
@@ -30,27 +30,34 @@ KOTS is an open source project that is maintained by Replicated. For more inform
 
 ## About Installing with KOTS
 
-The following diagram demonstrates the options for installing an application with KOTS, including installing in an existing cluster, an embedded cluster, and in air gap environments:
+KOTS can be used to install applications in Kubernetes clusters, including air gapped clusters, embedded clusters provisioned on VMs or bare metal servers with Replicated kURL, or any existing cluster brought by the user.
+
+To install an application with KOTS, users first run an installation script to install KOTS in the target cluster and deploy the KOTS admin console. After KOTS is installed, users can log in to the KOTS admin console to upload their license file, configure the application, run preflight checks, and install and deploy the application.
+
+The following diagram demonstrates how a single application release promoted the Stable channel in the Replicated vendor platform can be installed using KOTS in an embedded cluster on a VM, in an air gapped cluster, and in an existing internet-connected cluster:
 
 <img alt="Embedded cluster, air gap, and existing cluster app installation workflows" src="/images/kots-installation-overview.png" width="650px"/>
 
 [View a larger version of this image](/images/kots-installation-overview.png)
 
-As shown in the diagram above, customers can install an application with KOTS by first installing KOTS in the cluster. Then, they can use KOTS to configure and install the application. 
+As shown in the diagram above: 
+* For installations into existing clusters with access to the internet, users run a command to install KOTS in their cluster.
+* For embedded cluster installations on VMs or bare metal servers, users run an installation script that both provisions a cluster in their environment and installs KOTS in the cluster.
+* For installations in air gapped clusters, users download air gap bundles for KOTS and the application from the Replicated download portal and then provide the bundles during installation.
 
-KOTS is installed in Kubernetes clusters. Customers can install in their own existing cluster. Or, for customers that do not have a cluster or that have less experience with Kubernetes, KOTS can also be installed in an embedded cluster on a VM or bare metal server.
+All users are provided a license file that allows them to install with KOTS. After KOTS is installed in the cluster, users can access the KOTS admin console to provide their license file and deploy the application.
 
-For more information about kURL, see [Introduction to kURL](/vendor/kurl-about).
+For more information about how to install applications with KOTS, see the [Installing an Application](/enterprise/installing-overview) section.
 
 ## KOTS User Interfaces
 
-This section describest the interfaces that users can use to install and manage applications with KOTS.
+This section describes the KOTS interfaces available to users for installing and managing applications.
 
 ### KOTS Admin Console
 
-KOTS provides an admin console to make it easy for customers to install, upgrade, and manage their application instance.
+KOTS provides an admin console to make it easy for users to install, manage, update, configure, monitor, backup and restore, and troubleshoot their application instance from a GUI.
 
-The admin console is a user interface for KOTS that includes built-in functionality allowing users to install, manage, update, configure, monitor, backup and restore, and troubleshoot their application instances.
+The following shows an example of the admin console dashboard for an application:
 
 ![Admin Console Dashboard](/images/guides/kots/application.png)
 
@@ -62,4 +69,4 @@ The kots command-line interface (CLI) is a kubectl plugin. Customers can run com
 
 For information about getting started with the kots CLI, see [Installing the kots CLI](/reference/kots-cli-getting-started).
 
-For information about how to run automated installations with the kots CLI, see [Installing with Automation](/enterprise/installing-existing-cluster-automation).
+The kots CLI can also be used to install an application without needing to access the admin console. This can be useful for automating installations and upgrades. For information about how to run automated installations with the kots CLI, see [Installing with Automation](/enterprise/installing-existing-cluster-automation).

docs/vendor/kurl-about.mdx

@@ -1,6 +1,10 @@
 # Introduction to kURL
 
-This topic provides an introduction to the Replicated kURL installer.
+This topic provides an introduction to the Replicated kURL installer, including information about defining specifications for kURL clusters and installing with kURL.
+
+:::note
+The Replicated KOTS entitlement is required to install applications with KOTS and kURL. For more information, see [Pricing](https://www.replicated.com/pricing) on the Replicated website.
+:::
 
 ## Overview
 
@@ -42,6 +46,6 @@ For information about how to install applications in embedded clusters with KOTS
 
 ## About the Open Source kURL Documentation
 
-The kURL project has open source documentation at [kurl.sh](https://kurl.sh/docs/introduction/).
+The open source documentation for the kURL project is available at [kurl.sh](https://kurl.sh/docs/introduction/).
 
-The open source kURL documentation contains additional information about kURL installation options, kURL add-ons, and adding and managing nodes in kURL clusters. Software vendors can use the open source kURL documentation to find detailed reference information when creating Kubernetes installer specs or testing installation.
+The open source kURL documentation contains additional information including kURL installation options, kURL add-ons, and procedural content such as how to add and manage nodes in kURL clusters. Software vendors can use the open source kURL documentation to find detailed reference information when creating Kubernetes installer specs or testing installation.