Merge branch 'stable'

Author: mpilgrem

doc/README.md

@@ -131,6 +131,13 @@ Windows.
     use GHCup) is to download and install the
     [Windows installer](https://get.haskellstack.org/stable/windows-x86_64-installer.exe).
 
+    !!! warning
+
+        The Windows installer for Stack 2.9.1, 2.9.3 and 2.11.1 (current) (only)
+        will replace the user `PATH` environment variable (rather than append to
+        it) if a 1024 character limit is exceeded. If the content of your
+        existing user `PATH` is long, preserve it before running the installer.
+
     !!! note
 
         Systems with antivirus software may need to add Stack to the list of

doc/install_and_upgrade.md

@@ -431,6 +431,13 @@ GitHub repository.
     use GHCup) is to download and use the
     [Windows installer](https://get.haskellstack.org/stable/windows-x86_64-installer.exe).
 
+    !!! warning "Long user PATH environment variable"
+
+        The Windows installer for Stack 2.9.1, 2.9.3 and 2.11.1 (current) (only)
+        will replace the user `PATH` environment variable (rather than append to
+        it) if a 1024 character limit is exceeded. If the content of your
+        existing user `PATH` is long, preserve it before running the installer.
+
     !!! note "Anti-virus software"
 
         Systems with antivirus software may need to add Stack to the list of

doc/maintainers/releases.md

@@ -78,9 +78,14 @@ Examples:
     stack build --stack-yaml=… --haddock --test --bench --no-run-benchmarks
     ~~~
 
-7.  Ensure the integration tests pass on Linux, macOS and Windows.
+7.  The Windows installer is built using an
+    [NSIS compiler](https://nsis.sourceforge.io/Main_Page). Check that the NSIS
+    compiler that will be used is capable of handling
+    [large strings](https://nsis.sourceforge.io/Special_Builds).
 
-8.  Some people prefer, or need, to build Stack with Cabal (the tool). Check
+8.  Ensure the integration tests pass on Linux, macOS and Windows.
+
+9.  Some people prefer, or need, to build Stack with Cabal (the tool). Check
     that `cabal.project` is up to date (the specified `with-compiler:`). Check
     that `cabal.config` is up to date and is not missing dependencies relevant
     on Windows and non-Windows operating systems, following the instructions in