Downgrade WSL2 (#141)

* deprecate WSL2

* make debugging build work with buildkit

Author: gilesknap

docs/how-to/useful_k8s.md

@@ -86,6 +86,8 @@ sudo reboot
 
 ## Installing on Windows Subsystem for Linux
 
+I have had success with running k3s on WSL2, however, for best restults I would recommend using the VirtualBox applicance which is almost identical to a navtive Linux installation. These instructions have not been tested recently so YMMV.
+
 WSL2 gives you a linux distribution running within Windows, the following
 additional instructions explain how to use this platform.
 

docs/tutorials/debug_generic_ioc.md

@@ -37,6 +37,8 @@ Now rebuild the container - do this command from a new terminal *outside* of
 the devcontainer (make sure you have `ec` installed):
 
 ```bash
+# for docker users - builkit complicates debugging at present
+export DOCKER_BUILDKIT=0
 cd ioc-lakeshore340 # where you cloned it
 ./build
 ```

docs/tutorials/setup_k8s.md

@@ -43,7 +43,6 @@ option is to use a linux distribution that is supported by k3s.
 ========================== ============================================
 Ubuntu 20.10               any modern linux distro should also work
 Raspberry Pi OS 2021-05-07 See `raspberry`
-Windows WSL2               See `wsl`
 ========================== ============================================
 ```
 

docs/tutorials/setup_workstation.md

@@ -11,7 +11,7 @@ The tools you need to install are:
 
 Visual Studio Code is recommended because it has excellent integration with
 devcontainers. It also has useful extensions for working with Kubernetes,
-EPICS, WSL2 and more.
+EPICS, Yaml files and more.
 
 ## Options