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

[Joel Sherrill (@joel)]

Joel Sherrill commented on a discussion on user/start/bsp-build.md: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138141

 >  ```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.

I don't see a section with common issues/advice. Is there one? Where to we warn about disk space?

Could add a subsection early in "4 Host Computer" and reference it from the Quick Start.

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138141
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/20260108/b84e0eae/attachment-0001.htm>