From f007175574a73e7b04f5b8bd1bb27e71c7249a8a Mon Sep 17 00:00:00 2001
From: Brandon Hopkins <76761586+TechHutTV@users.noreply.github.com>
Date: Tue, 17 Feb 2026 03:50:06 -0800
Subject: [PATCH] Clearing Issues and General Fixes (#592)

* Upgrade link fix

* Fix on-page nav highlighting
---
 src/components/Layout.jsx                    | 17 ++++++++++-------
 src/pages/selfhosted/maintenance/upgrade.mdx |  4 ++--
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/src/components/Layout.jsx b/src/components/Layout.jsx
index 025700e2..a8dbc1f6 100644
--- a/src/components/Layout.jsx
+++ b/src/components/Layout.jsx
@@ -92,7 +92,7 @@ function useTableOfContents(tableOfContents) {
       .flatMap((node) => [node.id, ...node.children.map((child) => child.id)])
       .map((id) => {
         let el = document.getElementById(id)
-        if (!el) return
+        if (!el) return null
 
         let style = window.getComputedStyle(el)
         let scrollMt = parseFloat(style.scrollMarginTop)
@@ -100,20 +100,23 @@ function useTableOfContents(tableOfContents) {
         let top = window.scrollY + el.getBoundingClientRect().top - scrollMt
         return { id, top }
       })
+      .filter(Boolean)
   }, [])
 
   useEffect(() => {
     if (tableOfContents.length === 0) return
-    let headings = getHeadings(tableOfContents)
     function onScroll() {
+      let headings = getHeadings(tableOfContents)
+      if (headings.length === 0) return
+
       let scrollTop = window.scrollY
       setShowJumpToTop(scrollTop > 400)
-      
-      let top = scrollTop + 10;
-      let current = headings[0]?.id
+
+      let top = scrollTop + 10
+      let current = headings[0].id
       for (let heading of headings) {
-        if (top >= heading?.top) {
-          current = heading?.id
+        if (top >= heading.top) {
+          current = heading.id
         } else {
           break
         }
diff --git a/src/pages/selfhosted/maintenance/upgrade.mdx b/src/pages/selfhosted/maintenance/upgrade.mdx
index e64d405f..2a3de2a6 100644
--- a/src/pages/selfhosted/maintenance/upgrade.mdx
+++ b/src/pages/selfhosted/maintenance/upgrade.mdx
@@ -42,7 +42,7 @@ Management, Signal, and Relay are all part of the same repository and share the
 
 To upgrade NetBird to the latest version:
 
-1. Run the backup steps described in the [backup](#backup) section.
+1. Run the backup steps described in the [backup](/selfhosted/maintenance/backup) section.
 2. Review the release notes (see above) for any breaking changes.
 3. Pull the latest NetBird docker images:
     ```bash
@@ -54,7 +54,7 @@ To upgrade NetBird to the latest version:
     ```
 
 <Note>
-For upgrades from older versions (pre-v0.26.0), see the [Legacy upgrade notes](#legacy-self-hosting-with-zitadel-idp).
+For upgrades from older versions (pre-v0.26.0), see the [Legacy upgrade notes](#legacy-self-hosting-with-zitadel-idp) below.
 </Note>
 
 ### Legacy Setup (Separate Containers)