From d0d642fe82eaf1ba221d2109866d980fa3f6acde Mon Sep 17 00:00:00 2001
From: Paul Gottschling <paul.gottschling@goteleport.com>
Date: Thu, 12 Sep 2024 14:49:39 -0400
Subject: [PATCH] Add the Upgrading Reference to the sidebar

Backports #46490

Closes #46124

Add the Upgrading Reference as a sidebar entry to `config.json`, giving
it a more explicit slug.
---
 docs/config.json                                    | 13 +++++++++++--
 docs/pages/upgrading.mdx                            |  2 +-
 docs/pages/upgrading/automatic-agent-updates.mdx    |  2 +-
 .../{upgrading.mdx => upgrading-reference.mdx}      |  0
 4 files changed, 13 insertions(+), 4 deletions(-)
 rename docs/pages/upgrading/{upgrading.mdx => upgrading-reference.mdx} (100%)

diff --git a/docs/config.json b/docs/config.json
index eeaae12b79e57..e402f651bacd8 100644
--- a/docs/config.json
+++ b/docs/config.json
@@ -31,7 +31,11 @@
             {
               "title": "Set up Automatic Agent Updates",
               "slug": "/upgrading/automatic-agent-updates/"
-            }
+            },
+            {
+              "title": "Upgrading Reference",
+              "slug": "/upgrading/upgrading-reference/"
+	    }
           ]
         },
         {
@@ -2626,7 +2630,12 @@
     },
     {
       "source": "/upgrading/reference/",
-      "destination": "/upgrading/upgrading/",
+      "destination": "/upgrading/upgrading-reference/",
+      "permanent": true
+    },
+    {
+      "source": "/upgrading/upgrading/",
+      "destination": "/upgrading/upgrading-reference/",
       "permanent": true
     },
     {
diff --git a/docs/pages/upgrading.mdx b/docs/pages/upgrading.mdx
index 474b4249b7f0b..c66546df6e21f 100644
--- a/docs/pages/upgrading.mdx
+++ b/docs/pages/upgrading.mdx
@@ -17,7 +17,7 @@ Teleport cluster. You can also set up automatic agent upgrades in a self-hosted
 Enterprise cluster.
 
 For more information about upgrading, for example, to upgrade manually, read the
-[Upgrading Reference](upgrading/upgrading.mdx).
+[Upgrading Reference](upgrading/upgrading-reference.mdx).
 
 You can find more information regarding the automatic updates architecture in the
 [Agent Update Management](reference/architecture/agent-update-management.mdx) page.
diff --git a/docs/pages/upgrading/automatic-agent-updates.mdx b/docs/pages/upgrading/automatic-agent-updates.mdx
index 5fa4656ac33f0..84de72dd84bb1 100644
--- a/docs/pages/upgrading/automatic-agent-updates.mdx
+++ b/docs/pages/upgrading/automatic-agent-updates.mdx
@@ -35,7 +35,7 @@ regular maintenance window.
 
 - A Teleport Enterprise cluster. If you do not have one, [sign
   up](https://goteleport.com/signup) for a free trial or consult the [Update
-  Reference](upgrading.mdx) to read about manual updates.
+  Reference](upgrading-reference.mdx) to read about manual updates.
 - Familiarity with the [Upgrading Compatibility Overview](./overview.mdx) guide,
   which describes the sequence in which to upgrade components in your cluster.
 - Teleport agents that are not yet enrolled in automatic updates.
diff --git a/docs/pages/upgrading/upgrading.mdx b/docs/pages/upgrading/upgrading-reference.mdx
similarity index 100%
rename from docs/pages/upgrading/upgrading.mdx
rename to docs/pages/upgrading/upgrading-reference.mdx