Skip to content

Commit

Permalink
doc: Add guide for dev setup on Windows
Browse files Browse the repository at this point in the history
This adds a step-by-step guide to install a dev setup based on
WSL2 / Ubuntu and native VS Code with the WSL extension. The guide
uses screenshots and adds annotations on top using Inkscape, so that
every click is documented.

The Inkscape sources are also added to allow adjusting / fixing the
annotations later on without having to record a new set of screenshots.

Co-authored-by: Dylan Laduranty <dylan.laduranty@mesotic.com>
  • Loading branch information
maribu and dylad committed Feb 28, 2024
1 parent 0b385c6 commit 8b088c8
Show file tree
Hide file tree
Showing 77 changed files with 2,997 additions and 1 deletion.
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,11 @@ For specific toolchain installation, follow instructions in the
version of the documentation is uploaded daily to
[doc.riot-os.org](https://doc.riot-os.org).

Using Windows? Use [this guide][dev-setup-windows] to
[setup the development environment][dev-setup-windows].

[dev-setup-windows]: doc/guides/setup-windows

## Forum
Do you have a question, want to discuss a new feature, or just want to present
your latest project using RIOT? Come over to our [forum] and post to your hearts
Expand Down
7 changes: 6 additions & 1 deletion doc/doxygen/src/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,12 @@ will also be fine - however, we rely on users to report bugs regarding tooling i
here. So expect occasional issues for the development branch and please help testing during the
feature freeze period, if you develop on macOS or BSD.

Native development on Windows and macOS machines is not officially supported. What works well is using Linux
Windows users can refer to [this guide][dev-setup-windows] to
[setup the development environment][dev-setup-windows] on Windows.

[dev-setup-windows]: doc/guides/setup-windows

Native development on macOS machines is not officially supported. What works well is using Linux
in a virtual machine, but at much lower performance than running Linux natively. We also offer Docker images.
For development on Windows, using the
[Windows Subsystem for Linux (WSL)](https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux)
Expand Down
Loading

0 comments on commit 8b088c8

Please sign in to comment.