From 6256c52667cd84a7b76f2eed532be78c3a82ffb5 Mon Sep 17 00:00:00 2001
From: Hiroshi SHIBATA <hsbt@ruby-lang.org>
Date: Thu, 29 May 2025 13:15:08 +0900
Subject: [PATCH] Added VS2022 BuildTools instructions

---
 doc/windows.md | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/doc/windows.md b/doc/windows.md
index bb7a8478af..ffd1fed25d 100644
--- a/doc/windows.md
+++ b/doc/windows.md
@@ -81,9 +81,44 @@ sh ../../ruby/configure -C --disable-install-doc --with-opt-dir=C:\Users\usernam
       * VC++/MSVC on VS 2017/2019/2022 version build tools.
       * Windows 10/11 SDK
 
+    You can install Visual Studio Build Tools with `winget`. The minimum requirement manifest is:
+
+    ```json
+    {
+      "version": "1.0",
+      "components": [
+        "Microsoft.VisualStudio.Component.Roslyn.Compiler",
+        "Microsoft.Component.MSBuild",
+        "Microsoft.VisualStudio.Component.CoreBuildTools",
+        "Microsoft.VisualStudio.Workload.MSBuildTools",
+        "Microsoft.VisualStudio.Component.Windows10SDK",
+        "Microsoft.VisualStudio.Component.VC.CoreBuildTools",
+        "Microsoft.VisualStudio.Component.VC.Tools.x86.x64",
+        "Microsoft.VisualStudio.Component.VC.Redist.14.Latest",
+        "Microsoft.VisualStudio.Component.Windows11SDK.26100",
+        "Microsoft.VisualStudio.Component.TextTemplating",
+        "Microsoft.VisualStudio.Component.VC.CoreIde",
+        "Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core",
+        "Microsoft.VisualStudio.Workload.VCTools"
+      ],
+      "extensions": []
+    }
+    ```
+
+    You save the above JSON to a file like `minimum.vsconfig` and run the following command:
+
+    ```batch
+    winget install Microsoft.VisualStudio.2022.BuildTools --override "--passive --config minimum.vsconfig"
+    ```
+
 3.  Please set environment variable `INCLUDE`, `LIB`, `PATH`
     to run required commands properly from the command line.
-    These are set properly by `vcvarall*.bat` usually.
+    These are set properly by `vcvarall*.bat` usually. You can run
+    the following command to set them in your command line.
+
+    ```
+    cmd /k "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
+    ```
 
     **Note** building ruby requires following commands.