Merge branch 'main' into intro-kots

Author: paigecalvert

docs/intro-replicated.md

@@ -3,6 +3,7 @@ pagination_prev: null
 ---
 
 import ApiAbout from "/docs/partials/vendor-api/_api-about.mdx"
+import Kots from "/docs/partials/kots/_kots-definition.mdx"
 
 # Introduction to Replicated
 
@@ -62,9 +63,9 @@ Additionally, the Replicated proxy service grants proxy access to private applic
 
 ### Install
 
-Applications distributed with Replicated can be installed using any method, including the Helm CLI for Helm charts or any proprietary installation method already used by the ISV.
+Applications distributed with Replicated can be installed using the Helm CLI or the Replicated KOTS installer. The Helm CLI supports installation of Helm charts and KOTS supports installation of Helm charts and Kubernetes manifests.
 
-Replicated also offers the Replicated KOTS installer, which is a kubectl plugin that provides highly successful installs of Helm charts and Kubernetes applications into customer-controlled environments, including air gap environments. For users that have less experience with Kubernetes, KOTS supports installations onto VMs or bare metal servers through _embedded clusters_, which are provisioned in the customer environment at the time of installation.
+<Kots/>
 
 For more information, see the [KOTS documentation](intro-kots).
 

docs/intro.md

@@ -102,10 +102,10 @@ pagination_next: null
         <p>Helm</p>
     </li>
     <li>
-        <p>Distribute your Helm chart application with Replicated.</p>
+        <p>Distribute Helm-based applications with Replicated.</p>
     </li>
     <li>
-      <a href="/vendor/distributing-overview#helm">About Helm CLI installations</a>
+      <a href="/vendor/install-with-helm">About Helm CLI installations</a>
     </li>
     <li>
       <a href="/vendor/replicated-sdk-overview">Use the Replicated SDK</a>
@@ -116,9 +116,6 @@ pagination_next: null
     <li>
       <a href="/vendor/helm-image-registry">Use the proxy service for private images</a>
     </li>
-    <li>
-      <a href="/vendor/install-with-helm">Get Helm CLI installation instructions</a>
-    </li>
     <li>
       <a href="/vendor/licenses-reference-helm">Checking entitlements in Helm installations</a>
     </li>

docs/partials/getting-started/_replicated-definition.mdx

@@ -0,0 +1 @@
+Replicated is a commercial software distribution platform. Independent software vendors (ISVs) can use features of the Replicated platform to distribute modern enterprise software into complex, customer-controlled environments, including on-prem and air gap.

docs/partials/helm/_helm-charts-kots.mdx

@@ -0,0 +1 @@
+Helm is a popular open source package manager for Kubernetes applications. Many ISVs use Helm to configure and deploy Kubernetes applications because it provides a consistent, reusable, and sharable packaging format. For more information, see the [Helm documentation](https://helm.sh/docs).

docs/partials/helm/_helm-definition.mdx

@@ -1,5 +1,5 @@
 As shown in the diagram above, when a release containing one or more Helm charts is promoted to a channel, the Replicated vendor portal automatically extracts any Helm charts included in the release. These charts are pushed as OCI objects to the Replicated registry. The Replicated registry is a private OCI registry hosted by Replicated at `registry.replicated.com`. For information about security for the Replicated registry, see [Replicated Registry Security](packaging-private-registry-security).
 
-For example, if your application in the vendor portal is named My App and you promote a release containing a Helm chart with `name: my-chart` to the Beta channel, then the vendor portal pushes the chart to the following location: `oci://registry.replicated.com/my-app/beta/my-chart`.
+For example, if your application in the vendor portal is named My App and you promote a release containing a Helm chart with `name: my-chart` to a channel with the slug `beta`, then the vendor portal pushes the chart to the following location: `oci://registry.replicated.com/my-app/beta/my-chart`.
 
 Customers can install your Helm chart by first logging in to the Replicated registry with their unique license ID. This step ensures that any customer who installs your chart from the registry has a valid, unexpired license. After the customer logs in to the Replicated registry, they can run `helm install` to install the chart from the registry.

docs/partials/helm/_helm-diagram-overview.mdx

@@ -0,0 +1 @@
+Replicated KOTS is a kubectl plugin and an in-cluster admin console that provides highly successful installations of Helm charts and Kubernetes applications into customer-controlled environments, including on-prem and air gap environments. KOTS also supports installations onto VMs or bare metal servers through _embedded clusters_, which are clusters built from a customized Kubernetes distribution embedded with an application and provisioned in the customer environment at the time of installation.

docs/partials/kots/_kots-definition.mdx

@@ -0,0 +1,3 @@
+:::note
+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.
+:::

docs/partials/kots/_kots-entitlement-note.mdx

@@ -2,6 +2,6 @@
     <td><code>--output</code></td>
     <td>string</td>
     <td>
-      <p>The output format to use. <strong>Valid values:</strong> <code>json</code> or <code>table</code>. <strong>Default:</strong> table</p>
+      <p>The output format to use. <strong>Valid values:</strong> <code>json</code> or <code>table</code>. Some commands also support <code>wide</code> <strong>Default:</strong> table</p>
     </td>
 </tr>

docs/partials/replicated-cli/_output.mdx

@@ -0,0 +1,3 @@
+:::note
+If you see a `401 Unauthorized` error message, log out of the Replicated registry by running `helm registry logout registry.replicated.com` and then run `helm package . --dependency-update` again.
+:::