diff --git a/docs/Developer-Guide_Build-Preparation.md b/docs/Developer-Guide_Build-Preparation.md
index 5f3c1fda..9507efb0 100644
--- a/docs/Developer-Guide_Build-Preparation.md
+++ b/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