win32

install/README.md

@@ -1,11 +1,15 @@
 # Installation
 
+xrDebug is available as a self-contained binary, PHAR file, Composer package, Docker image, and source code. See [run](../run/README.md) for instructions on how to run the software.
+
 ## Self-contained binary <Badge text="recommended"/>
 
 Download latest `xrdebug` binary for your operating system and CPU architecture.
 
 ### macOS
 
+xrDebug package for macOS includes a GUI install wizard. Open the `.pkg` file to start the installation.
+
 | CPU     | Download                                                                                                         |
 | ------- | ---------------------------------------------------------------------------------------------------------------- |
 | Silicon | [xrdebug-macos-arm64.pkg](https://github.com/xrdebug/xrdebug/releases/latest/download/xrdebug-macos-arm64.pkg)   |
@@ -31,7 +35,9 @@ open xrdebug-macos-x86_64.pkg
 </code-group>
 :::
 
-### Linux
+### Linux & Windows WSL
+
+Download the `.tar.gz` file for your CPU architecture and extract it to a directory in your `PATH`.
 
 | CPU     | Download                                                                                                                 |
 | ------- | ------------------------------------------------------------------------------------------------------------------------ |

run/README.md

@@ -4,13 +4,23 @@ sidebar: false
 
 # Run
 
-To run xrDebug execute:
+To run xrDebug execute from terminal:
 
+<code-group>
+<code-block title="macOS/Linux">
 ```sh
 xrdebug <options>
 ```
+</code-block>
 
-> (*) Command location may vary depending on your [installation](../introduction/installation.md).
+<code-block title="Windows">
+```sh
+wsl ./xrdebug <options>
+```
+</code-block>
+</code-group>
+
+> (*) Where `xrdebug` and `./xrdebug` reflect the path to the executable file from [install](../install/).
 
 ## Options