diff --git a/.github/label-commenter-config.yml b/.github/label-commenter-config.yml
index 34e9e954f7..01a66faef9 100644
--- a/.github/label-commenter-config.yml
+++ b/.github/label-commenter-config.yml
@@ -7,5 +7,5 @@ labels:
     labeled:
       pr:
         body: |
-          This pull request includes breaking changes. **Please make sure that you included the breaking changes and the steps required to upgrade in [UPGRADING.md](https://github.com/secureCodeBox/secureCodeBox/blob/main/UPGRADING.md)**. 
+          This pull request includes breaking changes. **Please make sure that you included the breaking changes and the steps required to upgrade in [Upgrading](https://www.securecodebox.io/docs/getting-started/upgrading)**. 
           :sparkles: Thank you for your contribution! :sparkles:
diff --git a/README.md b/README.md
index 351236d844..3e0dfd4cc4 100644
--- a/README.md
+++ b/README.md
@@ -73,7 +73,7 @@ You can find resources to help you get started on our [documentation website](ht
 
 ## Upgrading
 
-For the steps required for upgrading your secureCodeBox installation, see [Upgrading](./UPGRADING.md).
+For the steps required for upgrading your secureCodeBox installation, see [Upgrading](https://www.securecodebox.io/docs/getting-started/upgrading).
 
 ## License
 
diff --git a/UPGRADING.md b/documentation/docs/getting-started/upgrading.md
similarity index 97%
rename from UPGRADING.md
rename to documentation/docs/getting-started/upgrading.md
index e1e1dad8c1..3d9fc30acd 100644
--- a/UPGRADING.md
+++ b/documentation/docs/getting-started/upgrading.md
@@ -1,11 +1,15 @@
-<!--
-SPDX-FileCopyrightText: the secureCodeBox authors
+---
+# SPDX-FileCopyrightText: the secureCodeBox authors
+#
+# SPDX-License-Identifier: Apache-2.0
 
-SPDX-License-Identifier: Apache-2.0
--->
 
-# Upgrading
+title: "Upgrading secureCodeBox"
+sidebar_label: Upgrading
+path: "docs/getting-started/upgrading"
+sidebar_position: 3
 
+---
 ## From 2.X to 3.X
 
 ### Upgraded Kubebuilder Version to v3
@@ -81,7 +85,7 @@ scanner:
 ➡️  [Reference: #484](https://github.com/secureCodeBox/secureCodeBox/pull/484)
 
 ### Added scanner.appendName to chart values
-Using {{ .Release.name }} in the `nmap` HelmChart Name for `scanTypes` causes issues when using this chart as a dependency of another chart. All scanners HelmCharts already used a fixed name for the `scanType` they introduce, with one exception: the `nmap` scanner HelmChart. 
+Using `{{ .Release.name }}` in the `nmap` HelmChart Name for `scanTypes` causes issues when using this chart as a dependency of another chart. All scanners HelmCharts already used a fixed name for the `scanType` they introduce, with one exception: the `nmap` scanner HelmChart. 
 
 The nmap exception was originally introduced to make it possible configure yourself an `nmap-privilidged` scanType, which is capable of running operating system scans which requires some higher privileges: https://www.securecodebox.io/docs/scanners/nmap#operating-system-scans