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] 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.
 
 ---------