Merge pull request #3000 from replicatedhq/florianhines/sc-118260/demote-channel-release-ui

Add documentation for channel release demotion

Author: pandemicsyn

docs/vendor/releases-about.mdx

@@ -179,6 +179,14 @@ If you enable semantic versioning for a channel and then promote releases to it,
 
 You can enable semantic versioning on a channel that already has releases promoted to it without semantic versioning. Any subsequently promoted releases must use semantic versioning. In this case, the channel will have releases with and without semantic version numbers. For information about how Replicated organizes these release sequences, see [Semantic Versioning Sequences](#semantic-versioning-sequence).
 
+### Demotion
+
+A channel release can be demoted from a channel. When a channel release is demoted, the release is longer available for download, but is not withdrawn from environments where it was already downloaded or installed.
+
+The demoted release's channel sequence and version are not reused. For customers, the release will appear to have been skipped. Un-demoting a release will restore its place in the channel sequence making it again available for download and installation.
+
+For information about how to demote a release, see [Demote a Release](/vendor/releases-creating-releases#demote-a-release) in _Managing Releases with the Vendor Portal_. 
+
 ## Vendor Portal Pages
 
 This section provides information about the channels and releases pages in the Vendor Portal.
@@ -205,7 +213,7 @@ As shown in the image above, you can do the following from the **Channels** page
 
    Click **Release history** to access the history of all releases promoted to the channel. From the **Release History** page, you can view the version labels and files in each release that has been promoted to the selected channel.
 
-   You can also build and download air gap bundles to be used in air gap installations with Replicated installers (Embedded Cluster, KOTS, kURL), and edit the release properties for each release promoted to the channel from the **Release History** page.
+   You can also build and download air gap bundles to be used in air gap installations with Replicated installers (Embedded Cluster, KOTS, kURL), edit the release properties for each release promoted to the channel from the **Release History** page, and demote a release from the channel.
 
    The following shows an example of the **Release History** page: 
 

docs/vendor/releases-creating-releases.mdx

@@ -91,14 +91,14 @@ To edit release properties:
 
 1. Go to **Channels**.
 1. In the channel where the release was promoted, click **Release History**.
-1. For the release sequence that you want to edit, click **Edit Release**.
+1. For the release sequence that you want to edit, open the dot menu and click **Edit release**.
 1. Edit the properties as needed.
     <img src="/images/release-properties.png" alt="Release Properties dialog in the Vendor Portal" width="300"/>
 
     [View a larger image](/images/release-properties.png)
 1. Click **Update Release**.
 
-## Archiving Releases
+## Archive a Release
 
 You can archive releases to remove them from view on the **Releases** page. Archiving a release that has been promoted does _not_ remove the release from the channel's **Release History** page or prevent KOTS from downloading the archived release.
 
@@ -107,4 +107,21 @@ To archive one or more releases:
 1. From the **Releases** page, click the trash can icon in the upper right corner.
 1. Select one or more releases.
 1. Click **Archive Releases**.
-1. Confirm the archive action when prompted.
+1. Confirm the archive action when prompted.
+
+## Demote a Release
+
+A channel release can be demoted from a channel. When a channel release is demoted, the release is longer available for download, but is not withdrawn from environments where it was already downloaded or installed. For more information, see [Demotion](/vendor/releases-about#demotion) in _About Channels and Releases_.
+
+For information about demoting and un-demoting releases with the Replicated CLI, see [channel demote](/reference/replicated-cli-channel-demote) and [channel un-demote](/reference/replicated-cli-channel-un-demote).
+
+To demote a release in the Vendor Portal:
+
+1. Go to **Channels**.
+1. In the channel where the release was promoted, click **Release History**.
+1. For the release sequence that you want to demote, open the dot menu and select **Demote Release**.
+
+   ![Release history page](/images/channels-release-history.png)
+   [View a larger version of this image](/images/channels-release-history.png)
+
+   After the release is demoted, the given release sequence is greyed out and a **Demoted** label is displayed next to the release on the **Release History** page.