From b5fdeddec390d32f51e3b2ddbac0296ad1a18a2f Mon Sep 17 00:00:00 2001
From: Germain Souquet <germain@souquet.com>
Date: Thu, 29 Apr 2021 15:36:10 +0100
Subject: [PATCH 1/2] Add Windows native module requirements

---
 README.md                    |  2 +-
 docs/windows-requirements.md | 23 +++++++++++++++++++++++
 2 files changed, 24 insertions(+), 1 deletion(-)
 create mode 100644 docs/windows-requirements.md

diff --git a/README.md b/README.md
index bbd4b96..b48b192 100644
--- a/README.md
+++ b/README.md
@@ -65,7 +65,7 @@ yarn run build:native
 ```
 
 On Windows, this will automatically determine the architecture to build for based
-on the environment (ie. set up by vcvarsall.bat).
+on the environment. Make sure that you have all the [tools required to perform the native modules build](docs/windows-requirements.md)
 
 Now you can build the package:
 
diff --git a/docs/windows-requirements.md b/docs/windows-requirements.md
new file mode 100644
index 0000000..ec791fa
--- /dev/null
+++ b/docs/windows-requirements.md
@@ -0,0 +1,23 @@
+# Windows
+
+## Requirements to build native modules
+
+If you want to build native modules, make sure that the following tools are installed on your system.
+
+- [Node 14](https://nodejs.org)
+- [Python 3](https://www.python.org/downloads/)
+- [Strawberry Perl](https://strawberryperl.com/)
+- [Rust](https://rustup.rs/)
+- [Visual Studio](https://visualstudio.microsoft.com/downloads/) with the following packages
+  - MSVC VS 2019 C++
+  - Windows 10 SDK
+  - C++ Clang tools
+
+Once installed make sure all those utilities are accessible in your `PATH`.
+In order to load all the C++ utilities installed by Visual Studio you can run the following in a terminal window.
+
+```
+call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64
+```
+
+You can replace `amd64` with `x86` depending on your CPU architecture.

From f98d1672af669b112f3b0108a2dfade91d23253d Mon Sep 17 00:00:00 2001
From: Germain <germain@souquet.com>
Date: Tue, 11 May 2021 12:41:24 +0100
Subject: [PATCH 2/2] Suggest installing Build tools rather than Visual Studio

Co-authored-by: J. Ryan Stinnett <jryans@gmail.com>
---
 docs/windows-requirements.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/docs/windows-requirements.md b/docs/windows-requirements.md
index ec791fa..6ff446e 100644
--- a/docs/windows-requirements.md
+++ b/docs/windows-requirements.md
@@ -8,10 +8,13 @@ If you want to build native modules, make sure that the following tools are inst
 - [Python 3](https://www.python.org/downloads/)
 - [Strawberry Perl](https://strawberryperl.com/)
 - [Rust](https://rustup.rs/)
-- [Visual Studio](https://visualstudio.microsoft.com/downloads/) with the following packages
-  - MSVC VS 2019 C++
-  - Windows 10 SDK
-  - C++ Clang tools
+- [Build Tools for Visual Studio 2019](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2019) with the following configuration:
+  - On the Workloads tab:
+    - Desktop & Mobile -> C++ build tools
+  - On the Individual components tab:
+    - MSVC VS 2019 C++ build tools
+    - Windows 10 SDK (latest version available)
+    - C++ CMake tools for Windows
 
 Once installed make sure all those utilities are accessible in your `PATH`.
 In order to load all the C++ utilities installed by Visual Studio you can run the following in a terminal window.