docs: feature stages (#6223)

bpmct · web-flow · commit 22cc6a3fb666 · 2023-02-15T15:51:31.000-06:00
diff --git a/docs/contributing/feature-stages.md b/docs/contributing/feature-stages.md
@@ -0,0 +1,25 @@
+# Feature stages
+
+Some Coder features are released as Alpha or Experimental.
+
+## Alpha features
+
+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.
+
+We recommend using [GitHub issues](https://github.com/coder/coder/issues) to leave feedback and get support for alpha features.
+
+## 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.
+
+```yaml
+# Enable all experimental features
+coder server --experiments=*
+
+# Enable multiple experimental features
+coder server --experiments=feature1,feature2
+
+# Alternatively, use the `CODER_EXPERIMENTS` environment variable.
+```
+
+Visit `https://<your-coder-url>/api/v2/experiments` to see which experimental features are available for your deployment.
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -318,6 +318,11 @@
           "description": "See the code of conduct for contributing to Coder",
           "path": "./contributing/CODE_OF_CONDUCT.md"
         },
+        {
+          "title": "Feature stages",
+          "description": "Policies for Alpha and Experimental features.",
+          "path": "./contributing/feature-stages.md"
+        },
         {
           "title": "Documentation",
           "description": "Our style guide for use when authoring documentation",
