Added WSL2 instructions

- Detailed limitations of WSL1: debug and run the Swift REPL. - Added instructions for WSL2 that allow to debug and REPL
filip-sakel · Nov 23, 2019 · f710598 · f710598
1 parent d2e1f09
commit f710598
Showing 1 changed file with 6 additions and 1 deletion.
diff --git a/docs/Windows.md b/docs/Windows.md
@@ -10,6 +10,11 @@ Currently there are two supported ways to build Swift for Windows.
 
 1. To build on Windows using Microsoft Visual C++ (MSVC), see [Building on Windows](./WindowsBuild.md#MSVC)
 
-## Windows Subsystem for Linux
+## Windows Subsystem for Linux (WSL)
 
 [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/about) is an Ubuntu environment.  Follow the instructions for building on [Linux](../README.md#linux)
+
+There two versions of WSL as of november 23, 2019:
+
+- WSL1: is the current stable version. Swift compilation and execution works but REPL and debugging (LLDB) hangs on startup.
+- WSL2: Both REPL and debugging work in this verion. WSL2 is still in development and is available by downloading an insider build. Fortunately, installing WSL2 is ppretty simple (switch to insider, download an insider build and run some scripts). WSL2 can be installed [by following this link](https://docs.microsoft.com/windows/wsl/wsl2-install).