move and edit SKirby's notes to markdown

EdwardAngert · EdwardAngert · commit a97d027d3c25 · 2024-09-24T16:23:27.000-04:00
diff --git a/docs/contributing/feature-stages.md b/docs/contributing/feature-stages.md
@@ -1,6 +1,8 @@
 # Feature stages
 
-Some Coder features are released as Alpha or Experimental.
+Some Coder features are released in feature stages before they are generally available.
+
+For more information about a specific feature, please contact _X_.
 
 ## Alpha features
 
@@ -11,11 +13,33 @@ 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.
 
+## Early access (EA) features
+
+Early access features are neither feature-complete nor stable.
+We do not recommend using EA features in production deployments.
+
+Coder releases EA features behind an “unsafe” experiment, where they’re
+accessible but not easy to find.
+
+### Early access support expectation
+
+Support for early access features is available through _X_.
+
 ## 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.
+production as they may cause performance or stability issues.
+In most cases, experimental features are complete, but require further
+internal testing and will only stay in the experimental stage for one or
+two weeks.
+
+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 +51,11 @@ coder server --experiments=feature1,feature2
 # Alternatively, use the `CODER_EXPERIMENTS` environment variable.
 ```
 
-## Available experimental features
+### Experimental features support expectation
+
+Support for experimental features is available through _X_.
+
+### Available experimental features
 
 <!-- Code generated by scripts/release/docs_update_experiments.sh. DO NOT EDIT. -->
 <!-- BEGIN: available-experimental-features -->
@@ -37,3 +65,13 @@ coder server --experiments=feature1,feature2
 | `notifications` | Sends notifications via SMTP and webhooks following certain events. | mainline, stable |
 
 <!-- END: available-experimental-features -->
+
+## 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.
+
+### Beta features support expectation
+
+Support for beta features is available through _X_.
