Skip to content

Update change-waves.md with process disposal instructions #11409

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Jan Provazník (JanProvaznik) wants to merge 4 commits into from
Closed

Update change-waves.md with process disposal instructions #11409

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
4a56d80
Update change-waves.md with process disposal instructions
JanProvaznik Jul 28, 2026
7b229cf
Update change waves documentation and add new section
chcomley Aug 13, 2026
a0d26a9
Remove change waves and reused processes section
chcomley Aug 13, 2026
49373b0
Update change-waves.md with MSBuild process info
chcomley Aug 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions docs/msbuild/change-waves.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Change waves
description: Learn how to enable or disable features in MSBuild that are potentially disruptive.
ms.date: 5/22/2026
ms.date: 08/13/2026
ms.topic: whats-new
helpviewer_keywords:
- Change waves [MSBuild]
Expand All @@ -19,7 +19,9 @@ When you upgrade to a new version of MSBuild, changes that are potentially break

## Opt out of change wave features

To disable the features in a change wave, set the environment variable `MSBuildDisableFeaturesFromVersion` to the change wave (or MSBuild version) that contains the feature you want **disabled**. This is the version of MSBuild that the features were developed for. See the mapping of change waves to features below.
To disable the features in a change wave, set the environment variable `MSBuildDisableFeaturesFromVersion` to the change wave (or MSBuild version) that contains the feature you want **disabled**. This is the version of MSBuild that the features were developed for. See the mapping of change waves to the following features.

Persistent MSBuild processes keep the value of `MSBuildDisableFeaturesFromVersion` that they started with. After you change the environment variable, shut down persistent build processes before you run another build. For builds run with the .NET CLI, use `dotnet build-server shutdown`. For builds run with Visual Studio or `MSBuild.exe`, close Visual Studio and end any remaining `MSBuild.exe` processes. Otherwise, reused processes might continue to use the previous value, and projects built in parallel might use different values.

### MSBuildDisableFeaturesFromVersion Values

Expand Down