diff --git a/doc/md/Installation_Instructions/Windows-Installation-Instructions.md b/doc/md/Installation_Instructions/Windows-Installation-Instructions.md
index 02e8a2201..8930c0a04 100644
--- a/doc/md/Installation_Instructions/Windows-Installation-Instructions.md
+++ b/doc/md/Installation_Instructions/Windows-Installation-Instructions.md
@@ -76,8 +76,15 @@ If you want to run the graphical components of the Proxmark3 client, you need to
 
 Enter WSL prompt (`wsl`) and from there, follow the [Linux Installation Instructions](/doc/md/Installation_Instructions/Linux-Installation-Instructions.md) for Ubuntu, summarized here below:
 
+Make sure your WSL guest OS is up-to-date first
 ```sh
 sudo apt-get update
+sudo apt-get upgrade -y
+sudo apt-get auto-remove -y
+```
+
+Install dependencies
+```sh
 sudo apt-get install --no-install-recommends git ca-certificates build-essential pkg-config \
 libreadline-dev gcc-arm-none-eabi libnewlib-dev libbz2-dev qtbase5-dev
 ```
diff --git a/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md b/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md
index e423752ab..c40d18458 100644
--- a/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md
+++ b/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md
@@ -24,6 +24,13 @@ git pull
 make clean && make all
 ```
 
+### if you got an error
+Read the [troubleshooting guide](/doc/md/Installation_Instructions/Troubleshooting.md), 
+
+For instance,  on WSl-1 you usually get the _libQt5Core.so.5 not found_ message
+[solution](/doc/md/Installation_Instructions/Troubleshooting.md#libQt5Coreso5-not-found)
+
+
 ## Install
 
 This is an optional step. If you do