From cc57f24062233e8c27cce7de096aa7fde9a70716 Mon Sep 17 00:00:00 2001
From: Paul Gottschling <paul.gottschling@goteleport.com>
Date: Wed, 11 Sep 2024 12:08:53 -0400
Subject: [PATCH] Add the Upgrading Reference to the sidebar

Closes #46124

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

diff --git a/docs/config.json b/docs/config.json
index 7d825c90cebd..29f7d215105c 100644
--- a/docs/config.json
+++ b/docs/config.json
@@ -29,9 +29,13 @@
               "slug": "/upgrading/overview/"
             },
             {
-                "title": "Set up Automatic Agent Updates",
-                "slug": "/upgrading/automatic-agent-updates/"
-            }
+              "title": "Set up Automatic Agent Updates",
+              "slug": "/upgrading/automatic-agent-updates/"
+            },
+            {
+              "title": "Upgrading Reference",
+              "slug": "/upgrading/upgrading-reference/"
+	    }
           ]
         },
         {
@@ -2568,7 +2572,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 474b4249b7f0..c66546df6e21 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 a4b4c82a29cb..1d5709753bcd 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