From e08ed00e05ea606485aed63daf793a8b00f41571 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 22 Apr 2026 17:39:54 +0000
Subject: [PATCH 1/7] Initial plan
From 9a53b9ab934c9f0a595e8bef40d9d32c250a58db Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 22 Apr 2026 17:41:54 +0000
Subject: [PATCH 2/7] docs: recommend rollForward disable when using lock files
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/14598f27-0fc3-4503-b326-f193c89ff142
Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
---
docs/core/tools/global-json.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md
index e0bd7e671b855..9319d389ba0d6 100644
--- a/docs/core/tools/global-json.md
+++ b/docs/core/tools/global-json.md
@@ -90,7 +90,7 @@ The following table shows the possible values for the `rollForward` key:
| `latestFeature` | Uses the highest installed feature band and patch level that matches the requested major and minor with a feature band and patch level that's greater than or equal to the specified value.
If not found, fails. |
| `latestMinor` | Uses the highest installed minor, feature band, and patch level that matches the requested major with a minor, feature band, and patch level that's greater than or equal to the specified value.
If not found, fails. |
| `latestMajor` | Uses the highest installed .NET SDK with a version that's greater than or equal to the specified value.
If not found, fail. |
-| `disable` | Doesn't roll forward. An exact match is required. |
+| `disable` | Doesn't roll forward. An exact match is required. This value is recommended when you use lock files so your SDK version and your dependency graph stay in lockstep. |
#### `paths`
From 276da22c76006bfc940d780b7b80ef1ea968786f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 22 Apr 2026 17:44:04 +0000
Subject: [PATCH 3/7] docs: clarify rollForward disable guidance for lock files
Agent-Logs-Url: https://github.com/dotnet/docs/sessions/14598f27-0fc3-4503-b326-f193c89ff142
Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
---
docs/core/tools/global-json.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md
index 9319d389ba0d6..0cd1898851857 100644
--- a/docs/core/tools/global-json.md
+++ b/docs/core/tools/global-json.md
@@ -90,7 +90,7 @@ The following table shows the possible values for the `rollForward` key:
| `latestFeature` | Uses the highest installed feature band and patch level that matches the requested major and minor with a feature band and patch level that's greater than or equal to the specified value.
If not found, fails. |
| `latestMinor` | Uses the highest installed minor, feature band, and patch level that matches the requested major with a minor, feature band, and patch level that's greater than or equal to the specified value.
If not found, fails. |
| `latestMajor` | Uses the highest installed .NET SDK with a version that's greater than or equal to the specified value.
If not found, fail. |
-| `disable` | Doesn't roll forward. An exact match is required. This value is recommended when you use lock files so your SDK version and your dependency graph stay in lockstep. |
+| `disable` | Don't roll forward. An exact match is required. When you use lock files, set this value so the SDK version and dependency graph stay in lockstep. |
#### `paths`
From 43ef5bf2734d42aa91e64da51be1ae37413c6b74 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Wed, 22 Apr 2026 14:07:59 -0700
Subject: [PATCH 4/7] Update 'disable' option description in global-json.md
Clarify the behavior of the 'disable' option in global.json.
---
docs/core/tools/global-json.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md
index 0cd1898851857..bc93bb3280194 100644
--- a/docs/core/tools/global-json.md
+++ b/docs/core/tools/global-json.md
@@ -90,7 +90,9 @@ The following table shows the possible values for the `rollForward` key:
| `latestFeature` | Uses the highest installed feature band and patch level that matches the requested major and minor with a feature band and patch level that's greater than or equal to the specified value.
If not found, fails. |
| `latestMinor` | Uses the highest installed minor, feature band, and patch level that matches the requested major with a minor, feature band, and patch level that's greater than or equal to the specified value.
If not found, fails. |
| `latestMajor` | Uses the highest installed .NET SDK with a version that's greater than or equal to the specified value.
If not found, fail. |
-| `disable` | Don't roll forward. An exact match is required. When you use lock files, set this value so the SDK version and dependency graph stay in lockstep. |
+| `disable` | Doesn't roll forward; an exact match is required.† |
+
+† When you use lock files, set `rollForward` to `disable` so the SDK version and dependency graph stay in lockstep. For related issues, see and .
#### `paths`
From a1fae463e3e59a188eb58a2e0acef5eb54a64330 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Wed, 22 Apr 2026 14:16:01 -0700
Subject: [PATCH 5/7] Update docs/core/tools/global-json.md
---
docs/core/tools/global-json.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md
index bc93bb3280194..c9d9af2ee0a0d 100644
--- a/docs/core/tools/global-json.md
+++ b/docs/core/tools/global-json.md
@@ -92,7 +92,7 @@ The following table shows the possible values for the `rollForward` key:
| `latestMajor` | Uses the highest installed .NET SDK with a version that's greater than or equal to the specified value.
If not found, fail. |
| `disable` | Doesn't roll forward; an exact match is required.† |
-† When you use lock files, set `rollForward` to `disable` so the SDK version and dependency graph stay in lockstep. For related issues, see and .
+ † When you use [package lock files](../install/upgrade.md#package-lock-files), set `rollForward` to `disable` so the SDK version and dependency graph stay in lockstep. For related issues, see and .
#### `paths`
From 986e7dc2a0d441535deff7bbc90399b85bc025b8 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Fri, 24 Apr 2026 11:34:58 -0700
Subject: [PATCH 6/7] Update docs/core/tools/global-json.md
Co-authored-by: Frulfump
---
docs/core/tools/global-json.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md
index c9d9af2ee0a0d..95720188320ec 100644
--- a/docs/core/tools/global-json.md
+++ b/docs/core/tools/global-json.md
@@ -92,7 +92,7 @@ The following table shows the possible values for the `rollForward` key:
| `latestMajor` | Uses the highest installed .NET SDK with a version that's greater than or equal to the specified value.
If not found, fail. |
| `disable` | Doesn't roll forward; an exact match is required.† |
- † When you use [package lock files](../install/upgrade.md#package-lock-files), set `rollForward` to `disable` so the SDK version and dependency graph stay in lockstep. For related issues, see and .
+ † When you use [package lock files](../install/upgrade.md#package-lock-files), set `rollForward` to `disable` so the SDK version and dependency graph stay in lockstep. For related issues, see and .
#### `paths`
From ac6d84a898e37b49160e298c93dec33a65805d52 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Fri, 24 Apr 2026 11:35:39 -0700
Subject: [PATCH 7/7] Update docs/core/tools/global-json.md
---
docs/core/tools/global-json.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md
index 95720188320ec..e654e6d75cc9b 100644
--- a/docs/core/tools/global-json.md
+++ b/docs/core/tools/global-json.md
@@ -92,7 +92,7 @@ The following table shows the possible values for the `rollForward` key:
| `latestMajor` | Uses the highest installed .NET SDK with a version that's greater than or equal to the specified value.
If not found, fail. |
| `disable` | Doesn't roll forward; an exact match is required.† |
- † When you use [package lock files](../install/upgrade.md#package-lock-files), set `rollForward` to `disable` so the SDK version and dependency graph stay in lockstep. For related issues, see and .
+ † When you use [package lock files](../install/upgrade.md#package-lock-files), set `rollForward` to `disable` so the SDK version and dependency graph stay in lockstep. For related issues, see and .
#### `paths`