diff --git a/docs/actions-scripts.md b/docs/actions-scripts.md
index b2bc98259..d28f0b74b 100644
--- a/docs/actions-scripts.md
+++ b/docs/actions-scripts.md
@@ -141,8 +141,10 @@ We currently package version 16.1, with `datacheck`, `safetab`, and `safecount`
 As Stata is a commercial product, a license key is needed to use it.
 
 #### If you are a member of the `opensafely` GitHub organisation
-* If you are using Windows, then the `opensafely` command line software will
-automatically use the OpenSAFELY Stata license.
+* If you are using Windows, you must have the [Github Desktop
+  app](https://desktop.github.com/) installed and be logged into it. Then the
+  `opensafely` command line software will use that
+  app to obtain the OpenSAFELY Stata license automatically.
 * If you are using macOS:
    1. Download and install [GitHub's command-line tool (`gh`)](https://cli.github.com/)
    2. Run `gh auth login --web`. Select the "HTTPS" option, and follow the instructions
@@ -159,11 +161,8 @@ If you are not a member of the `opensafely` GitHub organisation, you must provid
     * On Linux, somewhere like `/usr/local/stata17/`
     * On macOS it's usually in `/Applications/Stata/`
 2. Within that file, locate a license string of the format `SerialNumber!Code!Authorization!User!Organisation!VersionCode`.
-3. Set it as an environment variable using a [method appropriate to your operating system](https://chlee.co/how-to-setup-environment-variables-for-windows-mac-and-linux/). On Linux or macOS, you'd do it like this:
-        ```bash
-        export STATA_LICENSE='your license string'
-        ```
-The `opensafely` command line software will now automatically use this Stata license.
+3. Set it as an environment variable using a [method appropriate to your operating system](https://chlee.co/how-to-setup-environment-variables-for-windows-mac-and-linux/). The name of the environment variable should be `STATA_LICENSE`, and its contents should be the entire license string.
+The `opensafely` command line software should now automatically use this Stata license after opening a new terminal.
 
 
 ### Python