diff --git a/Firmware-Compatibility.md b/Firmware-Compatibility.md
index c948f3c..e0f1053 100644
--- a/Firmware-Compatibility.md
+++ b/Firmware-Compatibility.md
@@ -1,27 +1,17 @@
-## Mainboard
-Typically, the mainboard brain is an [STM32F103RCT6](/docs/literature/[10]_STM32F103xC_datasheet.pdf), however some mainboards feature a [GD32F103RCT6](/docs/literature/[11]_GD32F103xx-Datasheet-Rev-2.7.pdf) which is also supported by this firmware.
-For the reverse-engineered schematics of the mainboard, see [20150722_hoverboard_sch.pdf](/docs/20150722_hoverboard_sch.pdf).
+# Mainboard
+The mainboards with a [STM32F103RCT6](/docs/literature/[10]_STM32F103xC_datasheet.pdf) or a [GD32F103RCT6](/docs/literature/[11]_GD32F103xx-Datasheet-Rev-2.7.pdf) should be supported by this firmware.
+For the reverse-engineered schematics of the mainboard, see [20150722_hoverboard_sch.pdf](/docs/20150722_hoverboard_sch.pdf).
+
Some boards have 6 wires on the hall sensors cable, with an additional white wire.
-For those you can use the alternate mapping by changing parameter BOARD_VARIANT in [config.h](https://github.com/EmanuelFeru/hoverboard-firmware-hack-FOC/blob/master/Inc/config.h)
+For those you can use the alternate mapping by changing parameter BOARD_VARIANT in [config.h](https://github.com/EmanuelFeru/hoverboard-firmware-hack-FOC/blob/master/Inc/config.h)
+It could be that your mainboard was designed differently, please check if the pin mapping is matching with the one in this [section](https://github.com/EFeru/hoverboard-firmware-hack-FOC/wiki/Firmware-Compatibility#pin-mapping).
-## Split Boards
-For split boards with a STM32F130C8 or GD32F130C8 chip, please check following [Firmware](https://github.com/flo199213/Hoverboard-Firmware-Hack-Gen2) and its forks.
-
-
-For split boards with a GD32F103C8, please check following [Firmware](https://github.com/JohMah/Hoverboard-JC2015.7.31.V2.0-Hack)
-
-
-
-For split boards with a GD32F130K6 chip, please check the progress on following [repository](https://github.com/JRomainG/GD32F130K6-hoverboard-hack).
-
-
-
-## Artery boards
-For boards with AT32F403RCT6 or AT32F413RCT7 chips, please check following [Firmware](https://github.com/cloidnerux/hoverboard-firmware-hack).
-
-
+## Troubleshooting
+* Motors are cogging/not running in a smooth way - please try to swap the phases. Usually, color-correct mapping (blue to blue, green to green, yellow to yellow) works fine. However, some hoverboards have a different layout then others, and this might be the reason your motor isn't spinning well
+* In speed mode, wheel are running at maximum speed - find the right mapping for hall sensors, firmware probably measures a speed with opposite sign
+* With hovercar variant in torque mode, braking actually accelerates - find the right mapping for hall sensors, firmware probably measures a speed with opposite sign
## Pin Mapping
This is the pin mapping this firmware is using, you might have to adapt it to your board variant in [defines.h](https://github.com/EmanuelFeru/hoverboard-firmware-hack-FOC/blob/master/Inc/defines.h) file
@@ -65,7 +55,20 @@ This is the pin mapping this firmware is using, you might have to adapt it to yo
|BUTTON|PA1|PB9|
|CHARGER|PA12|PA11|
-## Troubleshooting
-* Motors are cogging/not running in a smooth way - please try to swap the phases. Usually, color-correct mapping (blue to blue, green to green, yellow to yellow) works fine. However, some hoverboards have a different layout then others, and this might be the reason your motor isn't spinning well
-* In speed mode, wheel are running at maximum speed - find the right mapping for hall sensors, firmware probably measures a speed with opposite sign
-* With hovercar variant in torque mode, braking actually accelerates - find the right mapping for hall sensors, firmware probably measures a speed with opposite sign
+# Other boards and available firmware
+## Artery boards
+For boards with AT32F403RCT6 or AT32F413RCT7 chips, please check following [Firmware](https://github.com/cloidnerux/hoverboard-firmware-hack).
+
+
+
+## Split Boards
+For split boards with a STM32F130C8 or GD32F130C8 chip, please check following [Firmware](https://github.com/flo199213/Hoverboard-Firmware-Hack-Gen2) and its forks.
+
+
+For split boards with a GD32F103C8, please check following [Firmware](https://github.com/JohMah/Hoverboard-JC2015.7.31.V2.0-Hack)
+
+
+
+For split boards with a GD32F130K6 chip, please check the progress on following [repository](https://github.com/JRomainG/GD32F130K6-hoverboard-hack).
+
+
\ No newline at end of file