diff --git a/docs/_config.yml b/docs/_config.yml
index 4a613844..1a775a77 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -40,11 +40,11 @@ exclude:
- CODE_OF_CONDUCT.md
aux_links:
- "GitHub":
+ " GitHub":
- "https://github.com/VzBoT3D"
- "Ko-Fi":
+ " Ko-Fi":
- https://ko-fi.com/vez3d
- "Discord":
+ " Discord":
- https://discord.gg/vzbot
# Makes Aux links open in a new tab. Default is false
diff --git a/docs/general/troubleshooting.md b/docs/general/troubleshooting.md
new file mode 100644
index 00000000..b574cf6a
--- /dev/null
+++ b/docs/general/troubleshooting.md
@@ -0,0 +1,45 @@
+---
+layout: default
+title: Maintenance
+parent: misc-info # temporarily here to clean up the sidebar links
+---
+
+# Troubleshooting
+
+Troubleshoot common problems with your printer
+
+## Printer homes in the wrong corner
+
+<<<<<<< HEAD
+Ensure your stepper motors are set up to rotate in the correct direction.
+[\[Stepper\] - Configuration reference](https://www.klipper3d.org/Config_Reference.html#stepper) (Klipper docs)
+
+Ensure the endstop positions for all axes are set correctly.
+See `position_endstop:` under your `[stepper]` configuration section.
+
+=======
+>>>>>>> b9a94e9f1a7ddb0830a97d54fbee0f9745e9c60e
+## Prints are mirrored
+
+You most likely have your motors set up wrong or mirrored. Make sure the physical motors match their counterpart configuration in your `printer.cfg` configuration file.
+
+[Verify stepper motors - Configuration checks](https://www.klipper3d.org/Config_checks.html#verify-stepper-motors) (Klipper docs)
+
+## Printer won't home
+
+Are the endstops connected? The stock VzBot uses mechanical endstops for homing.
+
+Klipper Docs have more information on checking endstop status and/or configuring sensorless homing
+
+* [Verify endstops - Configuration checks](https://www.klipper3d.org/Config_checks.html#verify-endstops) (Klipper docs)
+* [Sensorless homing - TMC drivers](https://www.klipper3d.org/TMC_Drivers.html?h=sensorless#sensorless-homing) (Klipper docs)
+
+## Printer is losing position
+
+This can sometimes be caused by lost steps due to excessive speed, acceleration or both.
+Ensure your printer is not set up to use StealthChop. SpreadCycle is preferred, as it has better accuracy and less likelihood of losing steps.
+
+* [Tuning motor current - TMC drivers](https://www.klipper3d.org/TMC_Drivers.html?h=sensorless#tuning-motor-current) (Klipper docs)
+* [Setting "spreadCycle" vs "stealthChop" Mode - TMC drivers](https://www.klipper3d.org/TMC_Drivers.html?h=sensorless#setting-spreadcycle-vs-stealthchop-mode) (Klipper docs)
+
+[**Next:** Maintenance →](./maintenance){: .btn .btn-doc}
diff --git a/docs/vz235_mellow/electronics/Mellow Super8 V1.3.md b/docs/vz235_mellow/electronics/Mellow Super8 V1.3.md
index cd47ec2d..191c80b1 100644
--- a/docs/vz235_mellow/electronics/Mellow Super8 V1.3.md
+++ b/docs/vz235_mellow/electronics/Mellow Super8 V1.3.md
@@ -158,16 +158,16 @@ Next up is our 48V lines.
If using Wago's you run a +V line to the top Wago and a -V to the Bottom Wago. From there we can start distributing it to our 5160's.
-![48V setup](../../assets/images/manual/vz235_printed/electronics/48V_Setup.jpeg)
+![48V setup](../../assets/images/manual/vz235_printed/electronics/48V_Setup.jpg)
Plug in a Wire to the +V side of the wago and run it to your 5160. Put it in the Bottom slot like shown in the picture below.
Plug in a wire to the -V side of the Wago and run it to your 5160. Put it in the second slot of the 5160 like shown below.
-![5160_48V](../../assets/images/manual/vz235_printed/electronics/5160_48V.jpeg)
+![5160_48V](../../assets/images/manual/vz235_printed/electronics/5160_48V.jpg)
Now do this for all your 5160's like you see down below. That's all the wiring you have to do for 48V.
-![5160_48V_complete](../../assets/images/manual/vz235_printed/electronics/5160_48V_Complete.jpeg)
+![5160_48V_complete](../../assets/images/manual/vz235_printed/electronics/5160_48V_Complete.jpg)
One last IMPORTANT step to do is to link your 24V - to your 48V -. Like you see Below i used a piece of wire to connect my 24V Negative Wago to my 48V Negative Wago.
diff --git a/docs/vz330_mellow/electronics/Mellow Super8 V1.3.md b/docs/vz330_mellow/electronics/Mellow Super8 V1.3.md
index 2e6a74eb..a09d0cb5 100644
--- a/docs/vz330_mellow/electronics/Mellow Super8 V1.3.md
+++ b/docs/vz330_mellow/electronics/Mellow Super8 V1.3.md
@@ -157,17 +157,17 @@ Next up is our 48V lines.
If using Wago's you run a +V line to the top Wago and a -V to the Bottom Wago. From there we can start distributing it to our 5160's.
-![48V setup](../../assets/images/manual/vz235_printed/electronics/48V_Setup.jpeg)
+![48V setup](../../assets/images/manual/vz235_printed/electronics/48V_Setup.jpg)
Plug in a Wire to the +V side of the wago and run it to your 5160. Put it in the Bottom slot like shown in the picture below.
Plug in a wire to the -V side of the Wago and run it to your 5160. Put it in the second slot of the 5160 like shown below.
-![5160_48V](../../assets/images/manual/vz235_printed/electronics/5160_48V.jpeg)
+![5160_48V](../../assets/images/manual/vz235_printed/electronics/5160_48V.jpg)
Now do this for all your 5160's like you see down below. That's all the wiring you have to do for 48V.
-![5160_48V_complete](../../assets/images/manual/vz235_printed/electronics/5160_48V_Complete.jpeg)
+![5160_48V_complete](../../assets/images/manual/vz235_printed/electronics/5160_48V_Complete.jpg)
One last IMPORTANT step to do is to link your 24V - to your 48V -. Like you see Below i used a piece of wire to connect my 24V Negative Wago to my 48V Negative Wago.