From e629b9a99b5a23cc8b74a87f3e2287874afc84f0 Mon Sep 17 00:00:00 2001
From: Joe Lodin <joe.lodin@cockroachlabs.com>
Date: Thu, 19 Mar 2026 14:50:27 -0400
Subject: [PATCH] docs: clean up releases navigation (DOC-16117)

Reorganize the releases navigation to improve clarity:
- Remove "Staged Release Process" from releases nav
- Rename "Unsupported Versions" to "Download Archive"
- Move "Technical Advisories" to Reference section (v26.2 only)
- Move "Archived Documentation" to Reference section (v26.2 only)

This is Phase 1 of the releases navigation cleanup.

Co-Authored-By: roachdev-claude <roachdev-claude-bot@cockroachlabs.com>
---
 .../_includes/sidebar-all-releases.json       | 25 +------------------
 src/current/_includes/sidebar-releases.json   | 12 +--------
 .../v26.2/sidebar-data/reference.json         | 16 ++++++++++++
 3 files changed, 18 insertions(+), 35 deletions(-)

diff --git a/src/current/_includes/sidebar-all-releases.json b/src/current/_includes/sidebar-all-releases.json
index b494554174b..1c94d87ec7a 100644
--- a/src/current/_includes/sidebar-all-releases.json
+++ b/src/current/_includes/sidebar-all-releases.json
@@ -22,28 +22,12 @@
     "/releases/{{ site.versions["dev"] }}.html"
   ]
 }{% endunless %},
-{
-  "title": "Staged Release Process",
-  "urls": [
-    "/releases/staged-release-process.html"
-  ]
-},
 {
   "title": "Release Support Policy",
   "urls": [
     "/releases/release-support-policy.html"
   ]
 },
-{% assign advisories = site.pages | where_exp: "advisories", "advisories.path contains 'advisories'" | where_exp: "advisories", "advisories.index != 'true'" %}
-{
- "title": "Technical Advisories",
- "urls": [
-    "/advisories/index.html"
-   {% for x in advisories %}
-    ,"{{ x.url }}"
-   {% endfor %}
- ]
-},
 {
   "title": "Cloud Releases",
   "urls": [
@@ -63,15 +47,8 @@
   ]
 },
 {
-  "title": "Unsupported Versions",
+  "title": "Download Archive",
   "urls": [
     "/releases/unsupported-versions.html"
   ]
-},
-{
-  "title": "Archived Documentation",
-  "urls": [
-   
-  "/releases/archived-documentation.html"
-  ]
 }
diff --git a/src/current/_includes/sidebar-releases.json b/src/current/_includes/sidebar-releases.json
index 718ac222192..cac72fd4e00 100644
--- a/src/current/_includes/sidebar-releases.json
+++ b/src/current/_includes/sidebar-releases.json
@@ -64,18 +64,8 @@
     "/releases/kubernetes-operator.html"
   ]
 },
-{% assign advisories = site.pages | where_exp: "advisories", "advisories.path contains 'advisories'" | where_exp: "advisories", "advisories.index != 'true'" %}
 {
- "title": "Technical Advisories",
- "urls": [
-    "/advisories/index.html"
-   {% for x in advisories %}
-    ,"{{ x.url }}"
-   {% endfor %}
- ]
-},
-{
-  "title": "Unsupported Versions",
+  "title": "Download Archive",
   "urls": [
     "/releases/unsupported-versions.html"
   ]
diff --git a/src/current/_includes/v26.2/sidebar-data/reference.json b/src/current/_includes/v26.2/sidebar-data/reference.json
index f0165023115..2997792022c 100644
--- a/src/current/_includes/v26.2/sidebar-data/reference.json
+++ b/src/current/_includes/v26.2/sidebar-data/reference.json
@@ -442,6 +442,22 @@
             ]
           }
         ]
+      },
+      {%- assign advisories = site.pages | where_exp: "advisories", "advisories.path contains 'advisories'" | where_exp: "advisories", "advisories.index != 'true'" -%}
+      {
+        "title": "Technical Advisories",
+        "urls": [
+          "/advisories/index.html"
+          {%- for x in advisories -%}
+          ,"{{ x.url }}"
+          {%- endfor -%}
+        ]
+      },
+      {
+        "title": "Archived Documentation",
+        "urls": [
+          "/releases/archived-documentation.html"
+        ]
       }
     ]
   }