Merge pull request #2562 from replicatedhq/95831

Add Embedded Cluster to Replicated intro content

Author: paigecalvert

docs/intro-kots.md renamed to docs/intro-kots.mdx

@@ -12,14 +12,14 @@ The Replicated KOTS entitlement is required to install applications with KOTS. F
 
 <Kots/>
 
-KOTS communicates securely with the Replicated vendor platform to synchronize customer licenses, check for available application updates, send instance data, share customer-generated support bundles, and more.
+KOTS communicates securely with the Replicated Vendor Portal to synchronize customer licenses, check for available application updates, send instance data, share customer-generated support bundles, and more.
 
 Installing an application with KOTS provides access to features such as:
 
-* Support for air gap installations
-* Support for installations on VMs or bare metal servers
+* Support for air gap installations in environments with limited or no outbound internet access
+* Support for installations on VMs or bare metal servers, when using Replicated Embedded Cluster or Replicated kURL
 * 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
+* 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
 * Support for marking releases as required to prevent users from skipping them during upgrades
@@ -28,25 +28,25 @@ KOTS is an open source project that is maintained by Replicated. For more inform
 
 ## About Installing with KOTS
 
-KOTS can be used to install applications in Kubernetes clusters, including:
+KOTS can be used to install Kubernetes applications and Helm charts in the following environments:
+* Clusters provisioned on VMs or bare metal servers with Replicated Embedded Cluster or Replicated kURL
 * Existing clusters brought by the user
-* Online or air gapped clusters
-* Embedded clusters provisioned on VMs or bare metal servers with Replicated Embedded Cluster or Replicated kURL
+* Online (internet-connected) or air-gapped (disconnected) environments
 
-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.
+To install an application with KOTS, users first run an installation script that installs KOTS in the target cluster and deploys 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 release promoted to 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:
+The following diagram demonstrates how a single release promoted to the Stable channel in the Vendor Portal can be installed with KOTS in an embedded cluster on a VM, in an existing 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"/>
 
 [View a larger version of this image](/images/kots-installation-overview.png)
 
 As shown in the diagram above: 
-* For installations in existing internet-connected clusters, 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.
+* For installations in existing online (internet-connected) clusters, users run a command to install KOTS in their cluster.
+* For installations on VMs or bare metal servers, users run an Embedded Cluster or kURL 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.
 
-All users must provide a license file 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.
+All users must have a valid license file to install with KOTS. After KOTS is installed in the cluster, users can access the KOTS Admin Console to provide their license and deploy the application.
 
 For more information about how to install applications with KOTS, see the [Installing an Application](/enterprise/installing-overview) section.
 
@@ -64,9 +64,15 @@ The following shows an example of the Admin Console dashboard for an application
 
 [View a larger version of this image](/images/guides/kots/application.png)
 
+For applications installed with Replicated Embedded Cluster in a VM or bare metal server, the Admin Console also includes a **Cluster Management** tab where users can add and manage nodes in the embedded cluster, as shown below:
+
+![Admin console dashboard with Cluster Management tab](/images/gitea-ec-ready.png)
+
+[View a larger version of this image](/images/gitea-ec-ready.png)
+
 ### KOTS CLI
 
-The kots command-line interface (CLI) is a kubectl plugin. Customers can run commands with the KOTS CLI to install and manage their application instances with KOTS programmatically.
+The KOTS command-line interface (CLI) is a kubectl plugin. Customers can run commands with the KOTS CLI to install and manage their application instances with KOTS programmatically.
 
 For information about getting started with the KOTS CLI, see [Installing the KOTS CLI](/reference/kots-cli-getting-started).