Merge pull request #18251 from cockroachdb/cloud-first-releases-page

Document Staged Release Process
cockroachdb · Jan 26, 2024 · 02acaad · 02acaad
2 parents b0288d6 + c5416cd
commit 02acaad
Show file tree

Hide file tree

Showing 4 changed files with 20 additions and 2 deletions.
diff --git a/src/current/_data/releases.yml b/src/current/_data/releases.yml
@@ -5385,10 +5385,10 @@
   release_date: '2024-01-17'
   release_type: Production
   cloud_only: true
-  cloud_only_message_short: 'Available in CockroachDB Dedicated. Self-hosted binaries <a href="https://www.cockroachlabs.com/docs/releases/v23.2#v23-2-0">available February 5</a>.'
+  cloud_only_message_short: 'Available in CockroachDB Dedicated. Self-hosted binaries <a href="https://www.cockroachlabs.com/docs/releases/v23.2#v23-2-0">available February 5</a> per the <a href="https://www.cockroachlabs.com/docs/releases/staged-release-process">staged release process</a>.'
   cloud_only_message: >
     CockroachDB v23.2 is now generally available for CockroachDB Dedicated,
-    and is scheduled to be made available for CockroachDB Self-Hosted on February 5, 2024.
+    and is scheduled to be made available for CockroachDB Self-Hosted on February 5, 2024 per the <a href="https://www.cockroachlabs.com/docs/releases/staged-release-process">staged release process</a>.
     For more information, refer to
     <a href="https://www.cockroachlabs.com/docs/cockroachcloud/create-your-cluster">Create a CockroachDB Dedicated Cluster</a> or
     <a href="https://www.cockroachlabs.com/docs/cockroachcloud/upgrade-to-v23.2">Upgrade to CockroachDB v23.2</a>.

diff --git a/src/current/_includes/sidebar-all-releases.json b/src/current/_includes/sidebar-all-releases.json
@@ -16,6 +16,12 @@
     "/releases/kubernetes-operator.html"
   ]
 },
+{
+  "title": "Staged Release Process",
+  "urls": [
+    "/releases/staged-release-process.html"
+  ]
+},
 {
   "title": "Release Support Policy",
   "urls": [

diff --git a/src/current/releases/index.md b/src/current/releases/index.md
@@ -27,6 +27,10 @@ For more details, refer to [Release Naming](#release-naming).
 In CockroachDB v22.2.x and above, a cluster that is upgraded to an alpha binary of CockroachDB or a binary that was manually built from the `master` branch cannot subsequently be upgraded to a production release.
 {{site.data.alerts.end}}
 
+## Staged release process
+
+As of 2024, CockroachDB is released under a staged delivery process. New releases are made available for CockroachDB Cloud clusters for two weeks before binaries are published for CockroachDB Self-Hosted downloads.
+
 {{ experimental_js_warning }}
 
 {% assign sections = site.data.releases | map: "release_type" | uniq | reverse %}

diff --git a/src/current/releases/staged-release-process.md b/src/current/releases/staged-release-process.md
@@ -0,0 +1,8 @@
+---
+title: Staged Release Process
+summary: Learn about Cockroach Labs' staged release process for CockroachDB Cloud and Self-Hosted releases.
+toc: true
+docs_area: releases
+---
+
+As of 2024, CockroachDB is released under a staged delivery process. New releases are made available for CockroachDB Cloud clusters for two weeks before binaries are published for CockroachDB Self-Hosted downloads.