From 41e215219bf2b8fd9ec8df15229fb8dabfd5b53f Mon Sep 17 00:00:00 2001
From: =?utf8?q?Miodrag=20Milanovi=C4=87?= <mmicko@gmail.com>
Date: Mon, 17 Jan 2022 10:07:56 +0100
Subject: [PATCH] Add info about VS build

---
 guidelines/Windows | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/guidelines/Windows b/guidelines/Windows
index 16ba57c9d..6cb91406c 100644
--- a/guidelines/Windows
+++ b/guidelines/Windows
@@ -37,6 +37,29 @@ Creating the Visual Studio Template Project
 
 4. Zip YosysVS as YosysVS-Tpl-v1.zip
 
+Compiling with Visual Studio
+============================
+
+Visual Studio builds are not directly supported by build scripts, but they are still possible.
+
+1. Easy way
+
+  - Go to https://github.com/YosysHQ/yosys/actions/workflows/vs.yml?query=branch%3Amaster
+  - Click on first item
+  - In Artifacts region find vcxsrc and click on it to download
+  - Unpack downloaded ZIP file
+  - Open YosysVS.sln with Visual Studio
+  
+2. Using WSL or MSYS2
+
+  - Make sure to have make, python3 and git available
+  - Git clone yosys repository
+  - Execute ```make vcxsrc YOSYS_VER=latest```
+  - File yosys-win32-vcxsrc-latest.zip will be created
+  - Transfer that file to location visible by Windows application
+  - Unpack ZIP
+  - Open YosysVS.sln with Visual Studio
+
 Cross-Building for Windows with MXE
 ===================================
 
-- 
2.30.2