Documentation | user/start: Add WSL path warning and clarify config.ini step (!202)

[Muhammad Kamran Khan (@Muhammad-Kamran-Khan)]

Muhammad Kamran Khan commented on a discussion on user/start/bsp-build.md: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138351

 >  ```none
 >  export PATH=$HOME/quick-start/rtems/@rtems-ver-major@/bin:"$PATH"
 >  ```
 > +> **Warning for Windows (WSL) Users:**
 > +> If you are using Windows Subsystem for Linux (WSL), ensure that you append to your existing PATH (using `:$PATH`) rather than overwriting it. Overwriting the PATH will cause Windows tools like `explorer.exe` or VS Code (`code`) to stop working from the terminal.
 > +>
 > +> **Solution:** If you lose access to these tools, you can still execute them using their absolute path (e.g., `/mnt/c/Windows/explorer.exe`) or restore access by restarting your terminal session.

@opticron Thank you for the feedback. You are absolutely right that overwriting PATH is bad practice in any environment. I specifically labeled this 'WSL' because the symptom (losing access to Windows tools like `explorer.exe` and `code`) is unique to WSL and very confusing for new users.

Would you prefer I change the header to a generic **"Warning regarding PATH"**, or keep it specific to WSL for this Quick Start guide?

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138351
You're receiving this email because of your account on gitlab.rtems.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/bugs/attachments/20260110/d7f018c8/attachment.htm>