Additional details on VS install

23ccozad · 23ccozad · commit 40676bb62f79 · 2022-05-06T21:35:08.000-04:00
The addition to this page informs Windows users building their development environment that they will need to ensure specific Visual Studio workloads are installed.
diff --git a/doc/users/installing/index.rst b/doc/users/installing/index.rst
@@ -111,10 +111,18 @@ First you need to install the :ref:`dependencies`.
 
 A C compiler is required.  Typically, on Linux, you will need ``gcc``, which
 should be installed using your distribution's package manager; on macOS, you
-will need xcode_; on Windows, you will need Visual Studio 2015 or later.
+will need xcode_; on Windows, you will need `Visual Studio`_ 2015 or later.
+
+For those using Visual Studio, make sure "Desktop development with C++" is
+selected, and that the latest MSVC, "C++ CMake tools for Windows," and a
+Windows SDK compatible with your version of Windows are selected and installed.
+They should be selected by default under the "Optional" subheading, but are
+required to build matplotlib from source.
 
 .. _xcode: https://guide.macports.org/chunked/installing.html#installing.xcode
 
+.. _Visual Studio: https://visualstudio.microsoft.com/downloads/
+
 The easiest way to get the latest development version to start contributing
 is to go to the git `repository <https://github.com/matplotlib/matplotlib>`_
 and run::
