From a3741607d9e566e57e32cbc4e366f8d15d4a14cc Mon Sep 17 00:00:00 2001
From: Adam Retter <adam.retter@googlemail.com>
Date: Sat, 18 Aug 2018 08:30:04 +0530
Subject: [PATCH] Bring Windows build details up to date. Requires Node 8.x and
 all can be done from cmd.exe (don't need different shells) Closes
 https://github.com/theia-ide/theia/issues/1614 See also
 https://github.com/theia-ide/theia/issues/2009

---
 doc/Developing.md | 78 ++++++++++++++++++++++++++++++++---------------
 1 file changed, 53 insertions(+), 25 deletions(-)

diff --git a/doc/Developing.md b/doc/Developing.md
index 317305cc8d928..f4beb94e09a9b 100644
--- a/doc/Developing.md
+++ b/doc/Developing.md
@@ -250,33 +250,61 @@ etc.) by opening `packages/<package name>/coverage/index.html`.
 
 ## Building on Windows
 
-Run cmd.exe as an administrator and install `choco` by copy-pasting the command
-to your console:
+1. Run cmd.exe as an Administrator. You can do this by pressing <kbd>Win</kbd>+<kbd>r</kbd> and entering `runas /user:Administrator cmd` in the open text box, and then clicking OK or pressing <kbd>Enter</kbd>.
 
-    @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
-
-Install `yarn` via `choco`. The `yarn` installation ensures that you will have
-Node.js and npm too:
-
-    choco install yarn
-
-Install `git` via `choco`
-
-    choco install git
-
-Install the correct version of `yarn` (The version is important)
+2. Install Chocolately (which will give you the `choco` command) by copy and pasting the command below into the Command Prompt, and then pressing the <kbd>return</kbd> key to run it:
 
-    choco install yarn --version 1.7.0 -y
-
-Install Windows-Build-Tools.
-Run PowerShell as an administrator and copy-paste the below command:
-
-    npm --add-python-to-path install --global --production windows-build-tools
-
-Clone, build and run Theia.
-Using Git Bash as administrator:
-
-    git clone https://github.com/theia-ide/theia.git && cd theia && yarn && cd examples/browser && yarn run start
+```ps
+    @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
+```
+
+3. Refresh the environment settings by running the following command in the Command Prompt: 
+```ps
+refreshenv
+```
+
+4. Install Node.js via. choco (**NOTE**: the version is important!) by running the following in the Command Prompt:
+```ps
+choco install nodejs.install --version 8.11.4 -y
+```
+
+5. Install Yarn via. choco (**NOTE**: the version is important!) by running the following in the Command Prompt:
+```ps
+choco install yarn --version 1.7.0 -y
+```
+
+6. Install Git via. choco:
+```ps
+choco install git -y
+```
+
+7. Refresh the environment settings by running the following command in the Command Prompt:
+```ps
+refreshenv
+```
+
+8. Install the Windows build tools via. npm:
+```ps
+npm --add-python-to-path install --global --production windows-build-tools
+```
+
+9. Refresh the environment settings by running the following command in the Command Prompt:
+```ps
+refreshenv
+```
+
+10. Clone, and build Theia:
+```ps
+git clone https://github.com/theia-ide/theia.git
+cd theia
+yarn
+```
+
+11. Run the Theia Browser Example app:
+```ps
+cd examples\browser
+yarn run start
+```
 
 ## Troubleshooting