docs(troubleshooting): overriding the $TERM to a more compatible value like xterm-256color

Author: danterolle

docs/Developer-Guide_Build-Preparation.md

@@ -68,6 +68,15 @@ Run framework:
 ./compile.sh [command] [switch...] [config...]
 ```
 
+!!! tip "Troubleshooting: 'unknown terminal type' error"
+When running the script, especially from modern terminal emulators (like Ghostty, Kitty, WezTerm), you might encounter an error like 'xterm-ghostty': unknown terminal type
+
+**Quick Workaround:** You can force a more common terminal type before running the script:
+```bash
+export TERM=xterm-256color
+./compile.sh
+```
+
 Only one command can be specified.
 
 Switches are parameter settings that are used by the build framework itself