From fe91f798baefd0650c90ad7db0140d09757dcc94 Mon Sep 17 00:00:00 2001
From: Imbus <>
Date: Fri, 15 Mar 2024 12:30:37 +0100
Subject: [PATCH] Better readme build instructions for windows

---
 README.md | 40 ++++++++++++++++++++++++++++++----------
 1 file changed, 30 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index e7b2dfe..062c54f 100644
--- a/README.md
+++ b/README.md
@@ -23,12 +23,16 @@ Dependencies:
 - [Podman](https://podman.io/) / [Docker](https://www.docker.com/)
 - [Just](https://github.com/casey/just) (Optional)
 
+### Fedora/Red Hat
+
 If you're on [Fedora](https://fedoraproject.org/)/Red Hat derivatives, this is as simple as:
 
 ```bash
 sudo dnf install -y make golang nodejs podman just
 ```
 
+### Debian/Ubuntu
+
 Any [Debian](https://www.debian.org/)/[Ubuntu](https://ubuntu.com/desktop)-based distro:
 
 ```bash
@@ -36,19 +40,43 @@ sudo apt install -y make golang nodejs podman
 sudo apt install -y just # For Ubuntu
 ```
 
+### Arch Linux
+
 [Arch Linux](https://archlinux.org/) & derivatives:
 
 ```bash
 sudo pacman -S make go nodejs npm podman just
 ```
 
+### MacOS
+
 [MacOS](https://www.apple.com/macos/): (Requires [Homebrew](https://brew.sh/)) (Untested)
 
 ```bash
 brew install make go nodejs npm podman just
 ```
 
-[Windows](https://www.microsoft.com/en-us/windows):  
+### Windows
+
+#### Vanilla Windows
+
+The project should now build properly on Windows, given the dependencies:
+
+- [Go](https://go.dev/)
+- [Node & npm](https://nodejs.org/en/)
+
+With chocolatey, you can install these dependencies with the following commands:
+
+```powershell
+choco install -y golang nodejs
+```
+
+Note that none of the convenience tools (Make, Podman, Just*) are available on Windows.
+
+*Just is available, but the targets are written for a Unix-like environment.
+
+#### Windows Subsystem for Linux (WSL)
+
 Unfortunately, [Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/install) is required for the build process. Running any form of containerized workload on windows is currently unsupported. More info [here](https://podman.io/docs/installation#windows). From my understanding, WSL also requires virtualization extensions to be enabled in the BIOS, which is not always the case for all users.
 
 It is possible to run the code on Windows, but this will be without the use of containers or any other build tools that are not available on Windows.
@@ -77,12 +105,4 @@ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
 nvm install node
 ```
 
-If you get any errors related to virtualization, you will need to enable virtualization in the BIOS. This is a common issue, and you can find a guide for your specific motherboard online. This is a one-time operation and will not affect your windows installation. This setting is usually called "VT-x" or "AMD-V" and is usually found in the CPU settings. If you can't find it, shoot me a message and I'll find it for you.
-
-If you're **still dead set** on using a vanilla Windows environment, you will need the following:
-
-- [Go](https://go.dev/)
-- [Node & npm](https://nodejs.org/en/)
-- [MariaDB](https://mariadb.org/) / [MySQL](https://www.mysql.com/) / [PostgreSQL](https://www.postgresql.org/) (This is undecided so far)
-
-With some grit and determination, you can get it to work. It's not recommended, but I (Imbus) will try to help you.
+If you get any errors related to virtualization, you will need to enable virtualization in the BIOS. This is a common issue, and you can find a guide for your specific motherboard online. This is a one-time operation and will not affect your windows installation. This setting is usually called "VT-x" or "AMD-V" and is usually found in the CPU settings.