diff --git a/docs/docs/troubleshooting.md b/docs/docs/troubleshooting.md
index ca70e6a8..a87fee42 100644
--- a/docs/docs/troubleshooting.md
+++ b/docs/docs/troubleshooting.md
@@ -3,90 +3,24 @@ id: troubleshooting
title: Troubleshooting
sidebar_title: Troubleshooting
---
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-export const OsTabs = (props) => ({props.children});
+The following page provides suggestions for common errors that may occur during firmware compilation. If the information provided is insufficient to resolve the issue, feel free to seek out help from the [ZMK Discord](https://discord.gg/VJnx9kr).
### Environment Variables not Defined
An error along the lines of `CMake Error at (zmk directory)/zephyr/cmake/generic_toolchain.cmake:64 (include): include could not find load file:` during firmware compilation indicates that the Zephyr Environment Variables are not properly defined.
-
-|  |
-| :-------------------------------------------------------------------------------: |
-| An example of the CMake Error on Windows 10 |
-
-
-
-
-To be completed!
-
-
-
-To be completed!
-
-
-
-To be completed!
-
-
-
-
-On Windows 10, navigate to the System Environment Variables page using the search bar.
-
-
-
-Click the button labelled 'Environment Variables'
-
-
-
-Add a new System Variable labelled `ZEPHYR_TOOLCHAIN_VARIANT` with a value of `gnuarmemb`.
-
-
-
-
-
-Repeat the previous steps to create another System Variable called `GNUARMEMB_TOOLCHAIN_PATH` with a value of the directory containing the GNU Arm Embedded Toolchain.
-
-
-
-:::note
-The folder for the GNUARMEMB_TOOLCHAIN_PATH should look something like this inside:
-
-
-:::
-
-Restart any terminals used to build firmware to check if the errors have been resolved.
-
-
-
-
-
-To be completed!
-
-
-
+For more information, click [here](../docs/dev-setup#environment-variables).
### Improperly defined keymap
-An error along the lines of `dtlib.DTError: BOARDNAME.dts.pre.tmp:LINENUMBER` during firmware compilation indicates an issue within the `shield.keymap` file.
+An error along the lines of `dtlib.DTError: .dts.pre.tmp:` during firmware compilation indicates an issue within the `.keymap` file.
This can be verified by checking the file in question, found in `mkdir/app/build`.
|  |
| :-------------------------------------------------------------------------------: |
| An example of the dtlib.DTError when compiling an iris with the nice!nano while the keymap is not properly defined |
-After opening the `BOARDNAME.dts.pre.tmp:LINENUMBER` and scrolling down to the referenced line, one can locate errors within their shield's keymap by checking if the referenced keycodes were properly converted into the correct [USB HID Usage ID](https://www.usb.org/document-library/hid-usage-tables-12).
+After opening the `.dts.pre.tmp:` and scrolling down to the referenced line, one can locate errors within their shield's keymap by checking if the referenced keycodes were properly converted into the correct [USB HID Usage ID](https://www.usb.org/document-library/hid-usage-tables-12).
|  |
| :-------------------------------------------------------------------------------: |
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 53c5cf3d..ba9715ef 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -24,5 +24,7 @@ module.exports = {
"dev-tests",
],
"Dev Guides": ["dev-guide-new-shield", "dev-guide-usb-logging"],
+
+ Troubleshooting:["troubleshooting"],
},
};