From 922473fb95e4d3f440bea8a53587a12716295d97 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 3 Aug 2026 17:33:50 +0000 Subject: [PATCH 01/15] Initial plan From d6390444ced68a615cccc21a60a693b13ce0e188 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 3 Aug 2026 17:36:12 +0000 Subject: [PATCH 02/15] Add dotnet-scaffold telemetry article and TOC entry --- docs/core/tools/dotnet-scaffold-telemetry.md | 70 ++++++++++++++++++++ docs/navigate/tools-diagnostics/toc.yml | 2 + 2 files changed, 72 insertions(+) create mode 100644 docs/core/tools/dotnet-scaffold-telemetry.md diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md new file mode 100644 index 0000000000000..2f59c13a4140a --- /dev/null +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -0,0 +1,70 @@ +--- +title: dotnet-scaffold telemetry +description: Learn about the telemetry collected by the dotnet-scaffold CLI tool. +author: tdykstra +ms.author: tdykstra +ms.date: 11/12/2024 +ai-usage: ai-assisted +uid: core/tools/dotnet-scaffold-telemetry +--- +# dotnet-scaffold telemetry + +The `dotnet-scaffold` command includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so it can be improved. + +## How to opt out + +The `dotnet-scaffold` telemetry feature is enabled by default. To opt out of the telemetry feature, set the `DOTNET_SCAFFOLD_TELEMETRY_OPTOUT` environment variable to `1` or `true`. + +## Disclosure + +When you run the `dotnet-scaffold` tool the first time, it displays output similar to the following example. The text may vary slightly depending on the version of the tool you're running. This "first run" experience is how Microsoft notifies you about data collection. + +```console +dotnet-scaffold collects usage data in order to help us improve your experience. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_SCAFFOLD_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell. + +Read more about dotnet-scaffold telemetry: +https://aka.ms/dotnet-scaffold/telemetry +Read more about .NET CLI Tools telemetry: +https://aka.ms/dotnet-cli-telemetry +``` + +To suppress the "first run" experience text, set the `DOTNET_SCAFFOLD_SKIP_FIRST_TIME_EXPERIENCE` environment variable to `1` or `true`. + +## Data points + +The telemetry feature doesn't collect: + +* Personal data, such as usernames, email addresses, or URLs. +* Any project data. + +The data is sent securely to Microsoft servers and held under restricted access. + +Protecting your privacy is important to us. If you suspect the telemetry feature is collecting sensitive data or the data is being insecurely or inappropriately handled, take one of the following actions: + +* File an issue in the [dotnet/scaffolding](https://github.com/dotnet/scaffolding/issues) repository. +* Send an email to [dotnet@microsoft.com](mailto:dotnet@microsoft.com) for investigation. + +The telemetry feature collects the following data. + +| .NET SDK versions | Data | +|--------------|------| +| >=8.0 | Timestamp of invocation. | +| >=8.0 | Three-octet IP address used to determine the geographical location. | +| >=8.0 | Operating system and version. | +| >=8.0 | Runtime ID (RID) the tool is running on. | +| >=8.0 | Whether the tool is running in a container. | +| >=8.0 | Hashed Media Access Control (MAC) address: a cryptographically (SHA256) hashed and unique ID for a machine. | +| >=8.0 | Kernel version. | +| >=8.0 | dotnet-scaffold version. | +| >=8.0 | Hashed tool information (tool name, tool version, tool package name, tool package version, chosen scaffolder category, related scaffolding categories) | +| >=8.0 | Tool level (global or local tool) | +| >=8.0 | Hashed command invoked (for example, `mvccontroller`) and whether it succeeded. | +| >=8.0 | dotnet-scaffold-aspnet scaffolder name, step names, and whether they succeeded. | +| >=8.0 | dotnet-scaffold-aspire scaffolder name and whether it succeeded. | +| >=8.0 | dotnet-scaffold aspnet scaffolder validation method name and whether they succeed. | +| >=8.0 | dotnet-scaffold aspire scaffolder validation method name and whether they succeed. | + +## Additional resources + +* [.NET SDK telemetry](telemetry.md) +* [.NET CLI telemetry data](https://dotnet.microsoft.com/platform/telemetry) diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml index 2d2ab180dd219..ee9de1c031783 100644 --- a/docs/navigate/tools-diagnostics/toc.yml +++ b/docs/navigate/tools-diagnostics/toc.yml @@ -19,6 +19,8 @@ items: href: ../../core/tools/test-prerelease-sdk-locally.md - name: Telemetry href: ../../core/tools/telemetry.md + - name: dotnet-scaffold telemetry + href: ../../core/tools/dotnet-scaffold-telemetry.md - name: Signed-package verification href: ../../core/tools/nuget-signed-package-verification.md - name: Artifacts output layout From 107faa1de35575c2a93bf7e78e9fe12b6777fab5 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 12:35:17 -0700 Subject: [PATCH 03/15] Apply suggestions from code review Co-authored-by: Wade Pickett --- docs/core/tools/dotnet-scaffold-telemetry.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index 2f59c13a4140a..7350d72d807f4 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -56,13 +56,13 @@ The telemetry feature collects the following data. | >=8.0 | Hashed Media Access Control (MAC) address: a cryptographically (SHA256) hashed and unique ID for a machine. | | >=8.0 | Kernel version. | | >=8.0 | dotnet-scaffold version. | -| >=8.0 | Hashed tool information (tool name, tool version, tool package name, tool package version, chosen scaffolder category, related scaffolding categories) | -| >=8.0 | Tool level (global or local tool) | +| >=8.0 | Hashed tool information (tool name, tool version, tool package name, tool package version, chosen scaffolder category, related scaffolding categories). | +| >=8.0 | Tool level (global or local tool). | | >=8.0 | Hashed command invoked (for example, `mvccontroller`) and whether it succeeded. | | >=8.0 | dotnet-scaffold-aspnet scaffolder name, step names, and whether they succeeded. | | >=8.0 | dotnet-scaffold-aspire scaffolder name and whether it succeeded. | -| >=8.0 | dotnet-scaffold aspnet scaffolder validation method name and whether they succeed. | -| >=8.0 | dotnet-scaffold aspire scaffolder validation method name and whether they succeed. | +| >=8.0 | dotnet-scaffold aspnet scaffolder validation method name and whether it succeed. | +| >=8.0 | dotnet-scaffold aspire scaffolder validation method name and whether it succeed. | ## Additional resources From b0fde13745fdabc1580074d0d0c2ca7120dbec89 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 13:29:42 -0700 Subject: [PATCH 04/15] Apply suggestions from code review Adding suggestions from gewarren review. Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- docs/core/tools/dotnet-scaffold-telemetry.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index 7350d72d807f4..822df29d8a88d 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -5,7 +5,6 @@ author: tdykstra ms.author: tdykstra ms.date: 11/12/2024 ai-usage: ai-assisted -uid: core/tools/dotnet-scaffold-telemetry --- # dotnet-scaffold telemetry @@ -17,7 +16,7 @@ The `dotnet-scaffold` telemetry feature is enabled by default. To opt out of the ## Disclosure -When you run the `dotnet-scaffold` tool the first time, it displays output similar to the following example. The text may vary slightly depending on the version of the tool you're running. This "first run" experience is how Microsoft notifies you about data collection. +When you run the `dotnet-scaffold` tool the first time, it displays output similar to the following example. The text might vary slightly depending on the version of the tool you're running. This "first run" experience is how Microsoft notifies you about data collection. ```console dotnet-scaffold collects usage data in order to help us improve your experience. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_SCAFFOLD_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell. From 922b475f182c70c43876b61d7158af5064c5b8ad Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 13:30:05 -0700 Subject: [PATCH 05/15] Apply suggestion from @gewarren Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- docs/core/tools/dotnet-scaffold-telemetry.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index 822df29d8a88d..1fca35bd2157b 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -60,8 +60,8 @@ The telemetry feature collects the following data. | >=8.0 | Hashed command invoked (for example, `mvccontroller`) and whether it succeeded. | | >=8.0 | dotnet-scaffold-aspnet scaffolder name, step names, and whether they succeeded. | | >=8.0 | dotnet-scaffold-aspire scaffolder name and whether it succeeded. | -| >=8.0 | dotnet-scaffold aspnet scaffolder validation method name and whether it succeed. | -| >=8.0 | dotnet-scaffold aspire scaffolder validation method name and whether it succeed. | +| >=8.0 | dotnet-scaffold aspnet scaffolder validation method name and whether it succeeded. | +| >=8.0 | dotnet-scaffold aspire scaffolder validation method name and whether it succeeded. | ## Additional resources From a174ca731f9b37476ccadddf6e2b416999f05780 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 13:34:53 -0700 Subject: [PATCH 06/15] Update ms.date in dotnet-scaffold telemetry doc Updated ms.date --- docs/core/tools/dotnet-scaffold-telemetry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index 1fca35bd2157b..bcd71e98ce6ff 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -3,7 +3,7 @@ title: dotnet-scaffold telemetry description: Learn about the telemetry collected by the dotnet-scaffold CLI tool. author: tdykstra ms.author: tdykstra -ms.date: 11/12/2024 +ms.date: 08/03/2026 ai-usage: ai-assisted --- # dotnet-scaffold telemetry From 8f51a185f56ac4734364c978206e09058f1a14b7 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 14:11:07 -0700 Subject: [PATCH 07/15] Apply suggestions from code review Co-authored-by: Wade Pickett --- docs/core/tools/dotnet-scaffold-telemetry.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index bcd71e98ce6ff..ab37fbe226fd7 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -8,7 +8,7 @@ ai-usage: ai-assisted --- # dotnet-scaffold telemetry -The `dotnet-scaffold` command includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so it can be improved. +The `dotnet-scaffold` command includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so they can improve it. ## How to opt out @@ -16,7 +16,7 @@ The `dotnet-scaffold` telemetry feature is enabled by default. To opt out of the ## Disclosure -When you run the `dotnet-scaffold` tool the first time, it displays output similar to the following example. The text might vary slightly depending on the version of the tool you're running. This "first run" experience is how Microsoft notifies you about data collection. +When you run the `dotnet-scaffold` tool for the first time, it displays output similar to the following example. The text might vary slightly depending on the version of the tool you're running. This "first run" experience is how Microsoft notifies you about data collection. ```console dotnet-scaffold collects usage data in order to help us improve your experience. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_SCAFFOLD_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell. From 80e4267543b83bd6ebe3a13cc6ed2bb280f52ced Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 14:50:57 -0700 Subject: [PATCH 08/15] Apply suggestion from @wadepickett Added missing hyphens --- docs/core/tools/dotnet-scaffold-telemetry.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index ab37fbe226fd7..b807b7d854a1b 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -60,8 +60,8 @@ The telemetry feature collects the following data. | >=8.0 | Hashed command invoked (for example, `mvccontroller`) and whether it succeeded. | | >=8.0 | dotnet-scaffold-aspnet scaffolder name, step names, and whether they succeeded. | | >=8.0 | dotnet-scaffold-aspire scaffolder name and whether it succeeded. | -| >=8.0 | dotnet-scaffold aspnet scaffolder validation method name and whether it succeeded. | -| >=8.0 | dotnet-scaffold aspire scaffolder validation method name and whether it succeeded. | +| >=8.0 | dotnet-scaffold-aspnet scaffolder validation method name and whether it succeeded. | +| >=8.0 | dotnet-scaffold-aspire scaffolder validation method name and whether it succeeded. | ## Additional resources From 16c8a056be455fcb0d18a937cd782c3908d8afa0 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 14:58:12 -0700 Subject: [PATCH 09/15] Revise telemetry data collection information Updated telemetry data collection details for .NET SDK version 8.0 and later. --- docs/core/tools/dotnet-scaffold-telemetry.md | 36 +++++++++----------- 1 file changed, 17 insertions(+), 19 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index b807b7d854a1b..cd6e350c9aead 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -43,25 +43,23 @@ Protecting your privacy is important to us. If you suspect the telemetry feature * File an issue in the [dotnet/scaffolding](https://github.com/dotnet/scaffolding/issues) repository. * Send an email to [dotnet@microsoft.com](mailto:dotnet@microsoft.com) for investigation. -The telemetry feature collects the following data. - -| .NET SDK versions | Data | -|--------------|------| -| >=8.0 | Timestamp of invocation. | -| >=8.0 | Three-octet IP address used to determine the geographical location. | -| >=8.0 | Operating system and version. | -| >=8.0 | Runtime ID (RID) the tool is running on. | -| >=8.0 | Whether the tool is running in a container. | -| >=8.0 | Hashed Media Access Control (MAC) address: a cryptographically (SHA256) hashed and unique ID for a machine. | -| >=8.0 | Kernel version. | -| >=8.0 | dotnet-scaffold version. | -| >=8.0 | Hashed tool information (tool name, tool version, tool package name, tool package version, chosen scaffolder category, related scaffolding categories). | -| >=8.0 | Tool level (global or local tool). | -| >=8.0 | Hashed command invoked (for example, `mvccontroller`) and whether it succeeded. | -| >=8.0 | dotnet-scaffold-aspnet scaffolder name, step names, and whether they succeeded. | -| >=8.0 | dotnet-scaffold-aspire scaffolder name and whether it succeeded. | -| >=8.0 | dotnet-scaffold-aspnet scaffolder validation method name and whether it succeeded. | -| >=8.0 | dotnet-scaffold-aspire scaffolder validation method name and whether it succeeded. | +The telemetry feature collects the following data for .NET SDK version 8.0 and later: + +* Timestamp of invocation. +* Three-octet IP address used to determine the geographical location. +* Operating system and version. +* Runtime ID (RID) the tool is running on. +* Whether the tool is running in a container. +* Hashed Media Access Control (MAC) address: a cryptographically (SHA256) hashed and unique ID for a machine. +* Kernel version. +* dotnet-scaffold version. +* Hashed tool information (tool name, tool version, tool package name, tool package version, chosen scaffolder category, related scaffolding categories). +* Tool level (global or local tool). +* Hashed command invoked (for example, `mvccontroller`) and whether it succeeded. +* dotnet-scaffold-aspnet scaffolder name, step names, and whether they succeeded. +* dotnet-scaffold-aspire scaffolder name and whether it succeeded. +* dotnet-scaffold-aspnet scaffolder validation method name and whether it succeeded. +* dotnet-scaffold-aspire scaffolder validation method name and whether it succeeded. ## Additional resources From 06a89a4cd8bcbe8958fdf33af5230bb8fec061e2 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 17:28:59 -0700 Subject: [PATCH 10/15] Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- docs/core/tools/dotnet-scaffold-telemetry.md | 24 ++++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index cd6e350c9aead..5d9dd80455443 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -31,18 +31,6 @@ To suppress the "first run" experience text, set the `DOTNET_SCAFFOLD_SKIP_FIRST ## Data points -The telemetry feature doesn't collect: - -* Personal data, such as usernames, email addresses, or URLs. -* Any project data. - -The data is sent securely to Microsoft servers and held under restricted access. - -Protecting your privacy is important to us. If you suspect the telemetry feature is collecting sensitive data or the data is being insecurely or inappropriately handled, take one of the following actions: - -* File an issue in the [dotnet/scaffolding](https://github.com/dotnet/scaffolding/issues) repository. -* Send an email to [dotnet@microsoft.com](mailto:dotnet@microsoft.com) for investigation. - The telemetry feature collects the following data for .NET SDK version 8.0 and later: * Timestamp of invocation. @@ -61,6 +49,18 @@ The telemetry feature collects the following data for .NET SDK version 8.0 and l * dotnet-scaffold-aspnet scaffolder validation method name and whether it succeeded. * dotnet-scaffold-aspire scaffolder validation method name and whether it succeeded. +The telemetry feature **does not** collect: + +* Personal data, such as usernames, email addresses, or URLs. +* Any project data. + +The data is sent securely to Microsoft servers and held under restricted access. + +Protecting your privacy is important to us. If you suspect the telemetry feature is collecting sensitive data or the data is being insecurely or inappropriately handled, take one of the following actions: + +* File an issue in the [dotnet/scaffolding](https://github.com/dotnet/scaffolding/issues) repository. +* Send an email to [dotnet@microsoft.com](mailto:dotnet@microsoft.com) for investigation. + ## Additional resources * [.NET SDK telemetry](telemetry.md) From 50bba0dfd5ff9c1eee1544546f9bd5ea58cebb7d Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 17:43:19 -0700 Subject: [PATCH 11/15] Update dotnet-scaffold-telemetry.md Imroved intro and links to the tool and additional resources per review suggestion. --- docs/core/tools/dotnet-scaffold-telemetry.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index 5d9dd80455443..b3ba04d1c50ef 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -10,6 +10,14 @@ ai-usage: ai-assisted The `dotnet-scaffold` command includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so they can improve it. +The `dotnet-scaffold` tool is a .NET global tool that generates code to speed up development. It isn't included with the .NET SDK, so install it separately with the following command: + +```dotnetcli +dotnet tool install --global Microsoft.dotnet-scaffold +``` + +For more information about the tool, see the [dotnet/Scaffolding repository](https://github.com/dotnet/Scaffolding) and the [Getting Started guide](https://github.com/dotnet/Scaffolding/blob/main/docs/Getting-Started.md). + ## How to opt out The `dotnet-scaffold` telemetry feature is enabled by default. To opt out of the telemetry feature, set the `DOTNET_SCAFFOLD_TELEMETRY_OPTOUT` environment variable to `1` or `true`. @@ -65,3 +73,6 @@ Protecting your privacy is important to us. If you suspect the telemetry feature * [.NET SDK telemetry](telemetry.md) * [.NET CLI telemetry data](https://dotnet.microsoft.com/platform/telemetry) +* [dotnet/Scaffolding repository](https://github.com/dotnet/Scaffolding) +* [Get started with dotnet-scaffold](https://github.com/dotnet/Scaffolding/blob/main/docs/Getting-Started.md) +* [Microsoft.dotnet-scaffold NuGet package](https://www.nuget.org/packages/Microsoft.dotnet-scaffold/) From e29cf77dc5a1180e53091ee910efd5b5d44ee019 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 17:44:50 -0700 Subject: [PATCH 12/15] Update telemetry documentation for dotnet-scaffold --- docs/core/tools/dotnet-scaffold-telemetry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index b3ba04d1c50ef..db83fbad7e722 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -10,7 +10,7 @@ ai-usage: ai-assisted The `dotnet-scaffold` command includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so they can improve it. -The `dotnet-scaffold` tool is a .NET global tool that generates code to speed up development. It isn't included with the .NET SDK, so install it separately with the following command: +`dotnet-scaffold` is a .NET global tool that generates code to speed up development. The telemetry feature applies when you use the tool, which isn't included with the .NET SDK. To install it, run the following command: ```dotnetcli dotnet tool install --global Microsoft.dotnet-scaffold From 3d4559bbf40da25b8d70d90168570596904a8a05 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 17:53:58 -0700 Subject: [PATCH 13/15] Apply suggestions from code review Co-authored-by: Wade Pickett --- docs/core/tools/dotnet-scaffold-telemetry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index db83fbad7e722..c2f1e1b9baa02 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -10,7 +10,7 @@ ai-usage: ai-assisted The `dotnet-scaffold` command includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so they can improve it. -`dotnet-scaffold` is a .NET global tool that generates code to speed up development. The telemetry feature applies when you use the tool, which isn't included with the .NET SDK. To install it, run the following command: +`dotnet-scaffold` is a .NET global tool that generates scaffolding code for common components, such as controllers, views, and pages, so you don't have to write that boilerplate by hand. The telemetry feature applies when you use the tool. `dotnet-scaffold` isn't included with the .NET SDK. To install it, run the following command: ```dotnetcli dotnet tool install --global Microsoft.dotnet-scaffold From 5f8c496591a4645e9feea5f6fd70321997993f1d Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 17:55:04 -0700 Subject: [PATCH 14/15] Apply suggestions from code review Co-authored-by: Wade Pickett --- docs/core/tools/dotnet-scaffold-telemetry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index c2f1e1b9baa02..55836ee9a255e 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -16,7 +16,7 @@ The `dotnet-scaffold` command includes a telemetry feature that collects usage d dotnet tool install --global Microsoft.dotnet-scaffold ``` -For more information about the tool, see the [dotnet/Scaffolding repository](https://github.com/dotnet/Scaffolding) and the [Getting Started guide](https://github.com/dotnet/Scaffolding/blob/main/docs/Getting-Started.md). +For more information about the `dotnet-scaffold` tool, see the [dotnet/Scaffolding repository](https://github.com/dotnet/Scaffolding) and the [Getting Started guide](https://github.com/dotnet/Scaffolding/blob/main/docs/Getting-Started.md). ## How to opt out From a7b0f9e960432e68f176a21259b611a321a38df1 Mon Sep 17 00:00:00 2001 From: Wade Pickett Date: Mon, 3 Aug 2026 18:02:46 -0700 Subject: [PATCH 15/15] Update dotnet-scaffold-telemetry.md Improved intro --- docs/core/tools/dotnet-scaffold-telemetry.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/core/tools/dotnet-scaffold-telemetry.md b/docs/core/tools/dotnet-scaffold-telemetry.md index 55836ee9a255e..a5b673876d7f9 100644 --- a/docs/core/tools/dotnet-scaffold-telemetry.md +++ b/docs/core/tools/dotnet-scaffold-telemetry.md @@ -8,15 +8,15 @@ ai-usage: ai-assisted --- # dotnet-scaffold telemetry -The `dotnet-scaffold` command includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so they can improve it. +The `dotnet-scaffold` tool includes a telemetry feature that collects usage data. This feature helps the `dotnet-scaffold` team understand how the tool is used so they can improve it. -`dotnet-scaffold` is a .NET global tool that generates scaffolding code for common components, such as controllers, views, and pages, so you don't have to write that boilerplate by hand. The telemetry feature applies when you use the tool. `dotnet-scaffold` isn't included with the .NET SDK. To install it, run the following command: +`dotnet-scaffold` is a .NET global tool that generates scaffolding code for common components, such as controllers, views, and pages, so you don't have to write that boilerplate by hand. It isn't included with the .NET SDK. To install it, run the following command: ```dotnetcli dotnet tool install --global Microsoft.dotnet-scaffold ``` -For more information about the `dotnet-scaffold` tool, see the [dotnet/Scaffolding repository](https://github.com/dotnet/Scaffolding) and the [Getting Started guide](https://github.com/dotnet/Scaffolding/blob/main/docs/Getting-Started.md). +For more information about the tool, see the [dotnet/Scaffolding repository](https://github.com/dotnet/Scaffolding) and the [Getting Started guide](https://github.com/dotnet/Scaffolding/blob/main/docs/Getting-Started.md). ## How to opt out