chore: update change log to v2.10.0 and install docs for release channels (#12863)

* 2.10.0 changelog

* updated install docs for mainline/stable releases

* make fmt

* cpp icon -> C++

* added disclaimer on MAX_TTL, support bundle info

* 'release schedule'

* lowercase mainline

* Agent OOM protection info

* minor tweak

docs/install/index.md

@@ -2,6 +2,9 @@
 
 A single CLI (`coder`) is used for both the Coder server and the client.
 
+We support two release channels: mainline and stable - read the
+[Releases](./releases.md) page to learn more about which best suits your team.
+
 There are several ways to install Coder. For production deployments with 50+
 users, we recommend [installing on Kubernetes](./kubernetes.md). Otherwise, you
 can install Coder on your local machine or on a VM:

docs/install/kubernetes.md

@@ -7,6 +7,15 @@ You'll also want to install the
 [latest version of Coder](https://github.com/coder/coder/releases/latest)
 locally in order to log in and manage templates.
 
+> Coder supports two release channels: mainline for the true latest version of
+> Coder, and stable for large enterprise deployments. Before installing your
+> control plane via Helm, please read the [Releases](./releases.md) document to
+> identify the best-suited release for your team, then specify the version using
+> Helm's `--version` flag.
+
+> The version flags for both stable and mainline are automatically filled in
+> this page.
+
 ## Install Coder with Helm
 
 1. Create a namespace for Coder, such as `coder`:
@@ -112,10 +121,22 @@ locally in order to log in and manage templates.
 
 1. Run the following command to install the chart in your cluster.
 
+   For the **mainline** Coder release:
+
    ```shell
    helm install coder coder-v2/coder \
        --namespace coder \
-       --values values.yaml
+       --values values.yaml \
+       --version 2.10.0
+   ```
+
+   For the **stable** Coder release:
+
+   ```shell
+   helm install coder coder-v2/coder \
+       --namespace coder \
+       --values values.yaml \
+       --version 2.9.1
    ```
 
    You can watch Coder start up by running `kubectl get pods -n coder`. Once

docs/install/releases.md

@@ -0,0 +1,56 @@
+# Releases
+
+Coder releases are cut directly from main in our
+[Github](https://github.com/coder/coder) on the first Tuesday of each month.
+
+We recommend enterprise customers test the compatibility of new releases with
+their infrastructure on a staging environment before upgrading a production
+deployment.
+
+We support two release channels:
+[mainline](https://github.com/coder/coder/2.10.0) for the edge version of Coder
+and [stable](https://github.com/coder/coder/releases/latest) for those with
+lower tolerance for fault. We field our mainline releases publicly for two weeks
+before promoting them to stable.
+
+### Mainline releases
+
+- Intended for customers with a staging environment
+- Gives earliest access to new features
+- May include minor bugs
+- All bugfixes and security patches are supported
+
+### Stable releases
+
+- Safest upgrade/installation path
+- May not include the latest features
+- Security vulnerabilities and major bugfixes are supported
+
+> Note: We support major security vulnerabilities (CVEs) for the past three
+> versions of Coder.
+
+## Installing stable
+
+When installing Coder, we generally advise specifying the desired version from
+our Github [releases page](https://github.com/coder/coder/releases).
+
+You can also use our `install.sh` script with the `stable` flag to install the
+latest stable release:
+
+```shell
+curl -fsSL https://coder.com/install.sh | sh -s -- --stable
+```
+
+Best practices for installing Coder can be found on our [install](./index.md)
+pages.
+
+## Release schedule
+
+| Release name | Date               | Status           |
+| ------------ | ------------------ | ---------------- |
+| 2.7.0        | January 01, 2024   | Not Supported    |
+| 2.8.0        | Februrary 06, 2024 | Security Support |
+| 2.9.0        | March 07, 2024     | Stable           |
+| 2.10.0       | April 03, 2024     | Mainline         |
+| 2.11.0       | May 07, 2024       | Not Released     |
+| 2.12.0       | June 04, 2024      | Not Released     |