From d6042463adf63319db12fb63ac4519c357e662b4 Mon Sep 17 00:00:00 2001 From: "Kimberly N. McGuire" Date: Mon, 3 Aug 2026 10:23:27 +0200 Subject: [PATCH 1/7] Add a check for the MSVC is properly installed Assisted-by: Claude Opus 4.8 (in browser) Signed-off-by: Kimberly N. McGuire --- .../Alternatives/Windows-Development-Setup.rst | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst index d60912eb1cf..62a3c2d7e6f 100644 --- a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst +++ b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst @@ -75,9 +75,15 @@ Now install MSVC 2022: $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK --add Microsoft.VisualStudio.Component.Windows11SDK.22621 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools -.. note:: +Now wait for a few momentsa as the installation of MSVC can take a long time, and there is no feedback while it is progressing. + +Once you are able to verify the installation path existince with the following check: + +.. code-block:: console + + $ "%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" -products * -version "[17.0,18.0)" -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath - The installation of MSVC can take a long time, and there is no feedback while it is progressing. +If you see a installation path (``C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools``), you can continue to the next installation steps. If not, you'll just need to wait a bit longer and try again. Install pixi ^^^^^^^^^^^^ From afbb0d632be2c735d42b5e4a3ebebcddc9a4603e Mon Sep 17 00:00:00 2001 From: "Kimberly N. McGuire" Date: Mon, 3 Aug 2026 10:29:59 +0200 Subject: [PATCH 2/7] MSVC installation arguments same as in CI and spelling check --- .../Alternatives/Windows-Development-Setup.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst index 62a3c2d7e6f..1bbee9f1db6 100644 --- a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst +++ b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst @@ -73,17 +73,17 @@ Now install MSVC 2022: .. code-block:: console - $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK --add Microsoft.VisualStudio.Component.Windows11SDK.22621 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools + $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows10SDK --add Microsoft.VisualStudio.Component.Windows10SDK.19041 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools -Now wait for a few momentsa as the installation of MSVC can take a long time, and there is no feedback while it is progressing. +Now wait for a few minutes as the installation of MSVC can take a long time, and there is no feedback while it is progressing. -Once you are able to verify the installation path existince with the following check: +Once you are able to verify the installation path existence with the following check: .. code-block:: console $ "%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" -products * -version "[17.0,18.0)" -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath -If you see a installation path (``C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools``), you can continue to the next installation steps. If not, you'll just need to wait a bit longer and try again. +If you see a installation path (``C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools``), you can continue to the next installation steps. If not, you'll just need to wait a bit longer and try checking the path again. Install pixi ^^^^^^^^^^^^ From 4762099d03dcc88006968da454c4c935b5c6f0ea Mon Sep 17 00:00:00 2001 From: Kimberly McGuire Date: Mon, 3 Aug 2026 10:35:43 +0200 Subject: [PATCH 3/7] revert win10 sdk to 11 --- .../Installation/Alternatives/Windows-Development-Setup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst index 1bbee9f1db6..5f4c4f690f1 100644 --- a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst +++ b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst @@ -73,7 +73,7 @@ Now install MSVC 2022: .. code-block:: console - $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows10SDK --add Microsoft.VisualStudio.Component.Windows10SDK.19041 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools + $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK --add Microsoft.VisualStudio.Component.Windows11SDK.19041 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools Now wait for a few minutes as the installation of MSVC can take a long time, and there is no feedback while it is progressing. From 9dbe40c69712ce99e5e4ec6d2f39a54b24fa59b6 Mon Sep 17 00:00:00 2001 From: Kimberly McGuire Date: Mon, 3 Aug 2026 10:50:06 +0200 Subject: [PATCH 4/7] new line for sentence --- .../Installation/Alternatives/Windows-Development-Setup.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst index 5f4c4f690f1..cfd0b2c36e3 100644 --- a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst +++ b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst @@ -83,7 +83,8 @@ Once you are able to verify the installation path existence with the following c $ "%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe" -products * -version "[17.0,18.0)" -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath -If you see a installation path (``C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools``), you can continue to the next installation steps. If not, you'll just need to wait a bit longer and try checking the path again. +If you see a installation path (``C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools``), you can continue to the next installation steps. +If not, you'll just need to wait a bit longer and try checking the path again. Install pixi ^^^^^^^^^^^^ From d321ec0b73503cd794d5dd62f6731b7dc116254c Mon Sep 17 00:00:00 2001 From: Kimberly McGuire Date: Mon, 3 Aug 2026 10:53:51 +0200 Subject: [PATCH 5/7] correct latest version visual studio --- .../Installation/Alternatives/Windows-Development-Setup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst index cfd0b2c36e3..0fdee1ef18b 100644 --- a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst +++ b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst @@ -73,7 +73,7 @@ Now install MSVC 2022: .. code-block:: console - $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK --add Microsoft.VisualStudio.Component.Windows11SDK.19041 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools + $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK --add Microsoft.VisualStudio.Component.Windows11SDK.22621 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools Now wait for a few minutes as the installation of MSVC can take a long time, and there is no feedback while it is progressing. From 69012d12c623edfccf2792921af9b4657a47af5e Mon Sep 17 00:00:00 2001 From: "Kimberly N. McGuire" Date: Tue, 4 Aug 2026 10:22:52 +0200 Subject: [PATCH 6/7] Update source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst Co-authored-by: Katherine Scott Signed-off-by: Kimberly N. McGuire --- .../Installation/Alternatives/Windows-Development-Setup.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst index 0fdee1ef18b..351bbe2b990 100644 --- a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst +++ b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst @@ -75,7 +75,8 @@ Now install MSVC 2022: $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK --add Microsoft.VisualStudio.Component.Windows11SDK.22621 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools -Now wait for a few minutes as the installation of MSVC can take a long time, and there is no feedback while it is progressing. + .. important:: + Now wait for a few minutes as the installation of MSVC can take a long time, and there is no feedback while it is progressing. Once you are able to verify the installation path existence with the following check: From 3edf21d2f8d3b1378d400b680e67990f614b1ec4 Mon Sep 17 00:00:00 2001 From: "Kimberly N. McGuire" Date: Wed, 5 Aug 2026 16:30:42 +0200 Subject: [PATCH 7/7] Apply suggestion from @knmcguire Signed-off-by: Kimberly N. McGuire --- .../Installation/Alternatives/Windows-Development-Setup.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst index 351bbe2b990..8e3afd9e05a 100644 --- a/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst +++ b/source/Get-Started/Installation/Alternatives/Windows-Development-Setup.rst @@ -75,7 +75,7 @@ Now install MSVC 2022: $ .\vs_buildtools_2022.exe --quiet --wait --norestart --add Microsoft.Component.MSBuild --add Microsoft.Net.Component.4.6.1.TargetingPack --add Microsoft.Net.Component.4.8.SDK --add Microsoft.VisualStudio.Component.CoreBuildTools --add Microsoft.VisualStudio.Component.Roslyn.Compiler --add Microsoft.VisualStudio.Component.TextTemplating --add Microsoft.VisualStudio.Component.VC.CLI.Support --add Microsoft.VisualStudio.Component.VC.CoreBuildTools --add Microsoft.VisualStudio.Component.VC.CoreIde --add Microsoft.VisualStudio.Component.VC.Redist.14.Latest --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK --add Microsoft.VisualStudio.Component.Windows11SDK.22621 --add Microsoft.VisualStudio.ComponentGroup.NativeDesktop.Core --add Microsoft.VisualStudio.Workload.MSBuildTools --add Microsoft.VisualStudio.Workload.VCTools - .. important:: +.. important:: Now wait for a few minutes as the installation of MSVC can take a long time, and there is no feedback while it is progressing. Once you are able to verify the installation path existence with the following check: