From c51903b65344f29709de66ab922bc2ca7e1a6929 Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <jessie.mongeon@dfinity.org>
Date: Mon, 9 Dec 2024 13:13:21 -0600
Subject: [PATCH 1/2] fix wsl instrucs

---
 docs/developer-docs/getting-started/install.mdx     |  2 ++
 .../getting-started/quickstart/react-quickstart.mdx | 13 ++++++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/docs/developer-docs/getting-started/install.mdx b/docs/developer-docs/getting-started/install.mdx
index ce5bc0a57f..6fa25c8f98 100644
--- a/docs/developer-docs/getting-started/install.mdx
+++ b/docs/developer-docs/getting-started/install.mdx
@@ -86,6 +86,8 @@ dfx --version
 
 #### Prerequisites
 
+`dfx` is not natively supported on Windows. You will need to install a Linux instance via Windows Subsystem for Linux and run all commands within that Linux instance.
+
 <input type="checkbox"/> Download and install <a href="https://docs.microsoft.com/en-us/windows/wsl/install"> Windows Subsystem for Linux</a>.
 <div>
 </div>
diff --git a/docs/developer-docs/getting-started/quickstart/react-quickstart.mdx b/docs/developer-docs/getting-started/quickstart/react-quickstart.mdx
index 9926b2d3a5..a014f52bd3 100644
--- a/docs/developer-docs/getting-started/quickstart/react-quickstart.mdx
+++ b/docs/developer-docs/getting-started/quickstart/react-quickstart.mdx
@@ -66,10 +66,21 @@ dfx --version
 
 #### Prerequisites
 
+`dfx` is not natively supported on Windows. You will need to install a Linux instance via Windows Subsystem for Linux and run all commands within that Linux instance.
+
 <input type="checkbox"/> Download and install <a href="https://docs.microsoft.com/en-us/windows/wsl/install"> Windows Subsystem for Linux</a>.
 <div>
 </div>
-<input type="checkbox"/> Download and <a href="https://nodejs.org/en/download/package-manager">install Node.js</a> within your WSL environment.
+<input type="checkbox"/> Open a WSL terminal window.
+<div>
+</div>
+<input type="checkbox"/> Download and install a Linux distribution (i.e., Ubuntu) using Windows Subsystem for Linux: <code>wsl --install -d ubuntu</code>
+<div>
+</div>
+<input type="checkbox"/> Open the WSL Linux environment. Run all following commands within this environment.
+<div>
+</div>
+<input type="checkbox"/> Download and <a href="https://learn.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-wsl">install Node.js</a> within your WSL Linux environment.
 
 ---------
 

From f28c397623b8c54a07d35bc97d1788ca104492ef Mon Sep 17 00:00:00 2001
From: Jessie Mongeon <jessie.mongeon@dfinity.org>
Date: Mon, 9 Dec 2024 13:13:36 -0600
Subject: [PATCH 2/2] fix wsl instrucs

---
 .../quickstart/first-smart-contract.mdx             | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/developer-docs/getting-started/quickstart/first-smart-contract.mdx b/docs/developer-docs/getting-started/quickstart/first-smart-contract.mdx
index de2e03f105..05ca775b97 100644
--- a/docs/developer-docs/getting-started/quickstart/first-smart-contract.mdx
+++ b/docs/developer-docs/getting-started/quickstart/first-smart-contract.mdx
@@ -111,10 +111,21 @@ project.
 
 #### Prerequisites
 
+`dfx` is not natively supported on Windows. You will need to install a Linux instance via Windows Subsystem for Linux and run all commands within that Linux instance.
+
 <input type="checkbox"/> Download and install <a href="https://docs.microsoft.com/en-us/windows/wsl/install"> Windows Subsystem for Linux</a>.
 <div>
 </div>
-<input type="checkbox"/> Download and <a href="https://nodejs.org/en/download/package-manager">install Node.js</a> within your WSL environment.
+<input type="checkbox"/> Open a WSL terminal window.
+<div>
+</div>
+<input type="checkbox"/> Download and install a Linux distribution (i.e., Ubuntu) using Windows Subsystem for Linux: <code>wsl --install -d ubuntu</code>
+<div>
+</div>
+<input type="checkbox"/> Open the WSL Linux environment. Run all following commands within this environment.
+<div>
+</div>
+<input type="checkbox"/> Download and <a href="https://learn.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-wsl">install Node.js</a> within your WSL Linux environment.
 
 ---------