diff --git a/docs/contributing/feature-stages.md b/docs/contributing/feature-stages.md
index 26eaf3272b47b..4489c212e25e0 100644
--- a/docs/contributing/feature-stages.md
+++ b/docs/contributing/feature-stages.md
@@ -1,21 +1,34 @@
# Feature stages
-Some Coder features are released as Alpha or Experimental.
+Some Coder features are released in feature stages before they are generally
+available.
-## Alpha features
+If you encounter an issue with any Coder feature, please submit a
+[GitHub issues](https://github.com/coder/coder/issues) or join the
+[Coder Discord](https://discord.gg/coder).
-Alpha features are enabled in all Coder deployments but the feature is subject
-to change, or even be removed. Breaking changes may not be documented in the
-changelog. In most cases, features will only stay in alpha for 1 month.
+## Early access features
-We recommend using [GitHub issues](https://github.com/coder/coder/issues) to
-leave feedback and get support for alpha features.
+Early access features are neither feature-complete nor stable. We do not
+recommend using early access features in production deployments.
+
+Coder releases early access features behind an “unsafe” experiment, where
+they’re accessible but not easy to find.
## Experimental features
These features are disabled by default, and not recommended for use in
production as they may cause performance or stability issues. In most cases,
-features will only stay in experimental for 1-2 weeks of internal testing.
+experimental features are complete, but require further internal testing and
+will stay in the experimental stage for one month.
+
+Coder may make significant changes to experiments or revert features to a
+feature flag at any time.
+
+If you plan to activate an experimental feature, we suggest that you use a
+staging deployment.
+
+You can opt-out of an experiment after you've enabled it.
```yaml
# Enable all experimental features
@@ -27,7 +40,7 @@ coder server --experiments=feature1,feature2
# Alternatively, use the `CODER_EXPERIMENTS` environment variable.
```
-## Available experimental features
+### Available experimental features
@@ -37,3 +50,14 @@ coder server --experiments=feature1,feature2
| `notifications` | Sends notifications via SMTP and webhooks following certain events. | mainline, stable |
+
+## Beta
+
+Beta features are open to the public, but are tagged with a `Beta` label.
+
+They’re subject to minor changes and may contain bugs, but are generally ready
+for use.
+
+## General Availability (GA)
+
+All other features have been tested, are stable, and are enabled by default.
diff --git a/docs/manifest.json b/docs/manifest.json
index ffea16703ce07..78aba3fb42ff1 100644
--- a/docs/manifest.json
+++ b/docs/manifest.json
@@ -1,7 +1,5 @@
{
- "versions": [
- "main"
- ],
+ "versions": ["main"],
"routes": [
{
"title": "About",
@@ -410,10 +408,7 @@
"description": "Learn how to use the role based access control against templates",
"path": "./admin/rbac.md",
"icon_path": "./images/icons/rbac.svg",
- "state": [
- "enterprise",
- "beta"
- ]
+ "state": ["enterprise", "beta"]
},
{
"title": "Configuration",
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy