From c929716be278d3a954a199d34ab41abb8964be99 Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Mon, 17 Nov 2025 15:06:03 -0800 Subject: [PATCH 1/4] Clarify global.json version support and update SDK availability notes --- docs/core/tools/global-json.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md index a10f8da2f828f..0c798f4b345ff 100644 --- a/docs/core/tools/global-json.md +++ b/docs/core/tools/global-json.md @@ -45,6 +45,7 @@ This field: - Doesn't have wildcard support; that is, you must specify the full version number. - Doesn't support version ranges. +- Doesn't support versions such as 9, 9.0, or 9.0.x, #### `allowPrerelease` @@ -90,7 +91,7 @@ The following table shows the possible values for the `rollForward` key: #### `paths` - Type: Array of `string` -- Available since: .NET 10 Preview 3 SDK. +- Available since: .NET 10 SDK. Specifies the locations that should be considered when searching for a compatible .NET SDK. Paths can be absolute or relative to the location of the *global.json* file. The special value `$host$` represents the location corresponding to the running `dotnet` executable. @@ -103,7 +104,7 @@ This feature enables using local SDK installations (such as SDKs relative to a r #### `errorMessage` - Type: `string` -- Available since: .NET 10 Preview 3 SDK. +- Available since: .NET 10 SDK. Specifies a custom error message displayed when the SDK resolver can't find a compatible .NET SDK. @@ -209,6 +210,17 @@ The following example shows how to specify additional SDK search paths and a cus } ``` +The following example shows that when an invalid version is specified, the output of `dotnet --info` shows: "Version '9.0' is not valid for the 'sdk/version' value." + +```json +{ + "sdk": { + "version": "9.0", + "rollForward": "latestFeature" + } +} +``` + The following example shows how to specify `Microsoft.Testing.Platform` as the test runner: ```json From d0741c6f762bfdd74a11d51b55c2932a6791472e Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Mon, 17 Nov 2025 15:42:16 -0800 Subject: [PATCH 2/4] update wording --- docs/core/tools/global-json.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md index 0c798f4b345ff..4e43b286ad9d5 100644 --- a/docs/core/tools/global-json.md +++ b/docs/core/tools/global-json.md @@ -43,9 +43,9 @@ The version of the .NET SDK to use. This field: +- Specify the full version number, such as 9.0.100. Doesn't support version numbers like 9, 9.0, or 9.0.x. - Doesn't have wildcard support; that is, you must specify the full version number. - Doesn't support version ranges. -- Doesn't support versions such as 9, 9.0, or 9.0.x, #### `allowPrerelease` @@ -210,12 +210,12 @@ The following example shows how to specify additional SDK search paths and a cus } ``` -The following example shows that when an invalid version is specified, the output of `dotnet --info` shows: "Version '9.0' is not valid for the 'sdk/version' value." +The following example shows an invalid version specified. The output of the command `dotnet --info` shows the error message: "Version '10.0' is not valid for the 'sdk/version' value." ```json { "sdk": { - "version": "9.0", + "version": "10.0", "rollForward": "latestFeature" } } From ddb088bbd354457d5b21d2232a3190a34477d8e4 Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Mon, 17 Nov 2025 16:16:06 -0800 Subject: [PATCH 3/4] Update docs/core/tools/global-json.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/core/tools/global-json.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/core/tools/global-json.md b/docs/core/tools/global-json.md index 4e43b286ad9d5..e0715b84e823f 100644 --- a/docs/core/tools/global-json.md +++ b/docs/core/tools/global-json.md @@ -43,7 +43,8 @@ The version of the .NET SDK to use. This field: -- Specify the full version number, such as 9.0.100. Doesn't support version numbers like 9, 9.0, or 9.0.x. +- Requires the full version number, such as 9.0.100. +- Doesn't support version numbers like 9, 9.0, or 9.0.x. - Doesn't have wildcard support; that is, you must specify the full version number. - Doesn't support version ranges. From dae87692c4989dfbf53d262388f6232032e6155c Mon Sep 17 00:00:00 2001 From: Meaghan Osagie Date: Mon, 17 Nov 2025 16:18:04 -0800 Subject: [PATCH 4/4] Clarify global.json version support --- 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 e0715b84e823f..cf343c3851629 100644 --- a/docs/core/tools/global-json.md +++ b/docs/core/tools/global-json.md @@ -45,7 +45,7 @@ This field: - Requires the full version number, such as 9.0.100. - Doesn't support version numbers like 9, 9.0, or 9.0.x. -- Doesn't have wildcard support; that is, you must specify the full version number. +- Doesn't have wildcard support. - Doesn't support version ranges. #### `allowPrerelease`