Update our install instructions, including WinGet script

docs/ai/quickstarts/chat-local-model.md

@@ -14,9 +14,9 @@ In this quickstart, you learn how to create a conversational .NET console chat a
 
 ## Prerequisites
 
-* [Install .NET 8.0](https://dotnet.microsoft.com/download) or higher
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
+
 * [Install Ollama](https://ollama.com/) locally on your device
-* [Visual Studio Code](https://code.visualstudio.com/) (optional)
 
 ## Run the local AI model
 

docs/ai/quickstarts/create-assistant.md

@@ -21,18 +21,16 @@ In this quickstart, you'll learn how to create a minimal AI assistant using the
 
 ::: zone pivot="openai"
 
-* [Install .NET 8.0](https://dotnet.microsoft.com/download) or higher
-* [Visual Studio Code](https://code.visualstudio.com/) (optional)
-* [Visual Studio](https://visualstudio.com/) (optional)
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
+
 * An access key for an OpenAI model
 
 :::zone-end
 
 ::: zone pivot="azure-openai"
 
-* [Install .NET 8.0](https://dotnet.microsoft.com/download) or higher
-* [Visual Studio Code](https://code.visualstudio.com/) (optional)
-* [Visual Studio](https://visualstudio.com/) (optional)
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
+
 * Access to an Azure OpenAI instance via Azure Identity or an access key
 
 :::zone-end

docs/ai/quickstarts/evaluate-ai-response.md

@@ -12,9 +12,9 @@ In this quickstart, you create an MSTest app to evaluate the chat response of a
 
 ## Prerequisites
 
-- [Install .NET 8.0](https://dotnet.microsoft.com/download) or a later version
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
+
 - [Install Ollama](https://ollama.com/) locally on your machine
-- [Visual Studio Code](https://code.visualstudio.com/) (optional)
 
 ## Run the local AI model
 

docs/ai/quickstarts/includes/ai-templates-azure-openai.md

@@ -8,10 +8,7 @@ ms.author: alexwolf
 
 ## Prerequisites
 
-* .NET 9.0 SDK - [Install the .NET 9.0 SDK](https://dotnet.microsoft.com/download)
-* Visual Studio 2022 - [Install Visual Studio 2022](https://visualstudio.microsoft.com/) (optional), or
-* Visual Studio Code - [Install Visual Studio Code](https://code.visualstudio.com) (optional)
-  * With the C# DevKit - [Install C# Dev Kit extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
 
 ## Install the .NET AI app template
 

docs/ai/quickstarts/includes/ai-templates-github-models.md

@@ -8,10 +8,7 @@ ms.author: alexwolf
 
 ## Prerequisites
 
-* .NET 9.0 SDK - [Install the .NET 9.0 SDK](https://dotnet.microsoft.com/download)
-* Visual Studio 2022 - [Install Visual Studio 2022](https://visualstudio.microsoft.com/) (optional), or
-* Visual Studio Code - [Install Visual Studio Code](https://code.visualstudio.com) (optional)
-  * With the C# DevKit - [Install C# Dev Kit extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
 
 ## Install the .NET AI app template
 

docs/ai/quickstarts/includes/ai-templates-ollama.md

@@ -8,10 +8,8 @@ ms.author: alexwolf
 
 ## Prerequisites
 
-* .NET 9.0 SDK - [Install the .NET 9.0 SDK](https://dotnet.microsoft.com/download)
-* Visual Studio 2022 - [Install Visual Studio 2022](https://visualstudio.microsoft.com/) (optional), or
-* Visual Studio Code - [Install Visual Studio Code](https://code.visualstudio.com) (optional)
-  * With the C# DevKit - [Install C# Dev Kit extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
+
 * Ollama installed locally - [Install Ollama](https://ollama.com/) locally on your device
 
 ## Install the .NET AI app template

docs/ai/quickstarts/includes/ai-templates-openai.md

@@ -8,10 +8,8 @@ ms.author: alexwolf
 
 ## Prerequisites
 
-* .NET 9.0 SDK - [Install the .NET 9.0 SDK](https://dotnet.microsoft.com/download)
-* Visual Studio 2022 - [Install Visual Studio 2022](https://visualstudio.microsoft.com/) (optional), or
-* Visual Studio Code - [Install Visual Studio Code](https://code.visualstudio.com) (optional)
-  * With the C# DevKit - [Install C# Dev Kit extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit)
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
+
 * Access to an [OpenAI service](https://openai.com/api/) and the corresponding API key.
 
 ## Install the .NET AI app template

docs/ai/quickstarts/includes/prerequisites-azure-openai.md

@@ -7,7 +7,8 @@ ms.topic: include
 
 ## Prerequisites
 
-- .NET 8.0 SDK or higher - [Install the .NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0).
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
+
 - An Azure subscription - [Create one for free](https://azure.microsoft.com/free).
 - Access to [Azure OpenAI service](/azure/ai-services/openai/overview#how-do-i-get-access-to-azure-openai).
 - Azure Developer CLI (optional) - [Install or update the Azure Developer CLI](/azure/developer/azure-developer-cli/install-azd).

docs/ai/quickstarts/includes/prerequisites-openai.md

@@ -7,5 +7,6 @@ ms.topic: include
 
 ## Prerequisites
 
-- .NET 8.0 SDK or higher - [Install the .NET 8.0 SDK](https://dotnet.microsoft.com/download/dotnet/8.0).
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
+
 - An [API key from OpenAI](https://platform.openai.com/docs/quickstart/account-setup) so you can run this sample.

docs/ai/tutorials/llm-eval.md

@@ -29,7 +29,8 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
 
 ## Prerequisites
 
-* [.NET 8.0 SDK](https://dotnet.microsoft.com/download/visual-studio-sdks)
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
+
 * [Create and deploy a GPT-4 model to Azure OpenAI Service](/azure/ai-services/openai/how-to/create-resource)
 
 ## 1 - Clone the evaluation application

docs/architecture/microservices/net-core-net-framework-containers/index.md

@@ -7,7 +7,7 @@ ms.date: 11/19/2021
 
 [!INCLUDE [download-alert](../includes/download-alert.md)]
 
-There are two supported frameworks for building server-side containerized Docker applications with .NET: [.NET Framework and .NET 8](https://dotnet.microsoft.com/download). They share many .NET platform components, and you can share code across the two. However, there are fundamental differences between them, and which framework you use will depend on what you want to accomplish. This section provides guidance on when to choose each framework.
+There are two supported frameworks for building server-side containerized Docker applications with .NET: [.NET Framework and .NET 9](https://dotnet.microsoft.com/download). They share many .NET platform components, and you can share code across the two. However, there are fundamental differences between them, and which framework you use will depend on what you want to accomplish. This section provides guidance on when to choose each framework.
 
 >[!div class="step-by-step"]
 >[Previous](../container-docker-introduction/docker-containers-images-registries.md)

docs/core/containers/sdk-publish.md

@@ -16,7 +16,7 @@ Containers have many features and benefits, such as being an immutable infrastru
 
 Install the following prerequisites:
 
-- [.NET 8+ SDK](https://dotnet.microsoft.com/download/dotnet/8.0)\
+- [.NET SDK](https://dotnet.microsoft.com/download/dotnet)\
 If you have .NET installed, use the `dotnet --info` command to determine which SDK you're using.
 
 If you plan on running the container locally, you need an Open Container Initiative (OCI)-compatible container runtime, such as:

docs/core/diagnostics/debug-threadpool-starvation.md

@@ -23,7 +23,7 @@ In this tutorial, you will:
 
 The tutorial uses:
 
-- [.NET Core 6.0 SDK](https://dotnet.microsoft.com/download/dotnet) to build and run the sample app
+- [.NET SDK](https://dotnet.microsoft.com/download/dotnet) to build and run the sample app
 - [Sample web app](/samples/dotnet/samples/diagnostic-scenarios) to demonstrate ThreadPool starvation behavior
 - [Bombardier](https://github.com/codesenberg/bombardier/releases) to generate load for the sample web app
 - [dotnet-counters](dotnet-counters.md) to observe performance counters

docs/core/extensions/dependency-injection-usage.md

@@ -23,7 +23,8 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-- [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download/dotnet) or later.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
+
 - Familiarity with creating new .NET applications and installing NuGet packages.
 
 ## Create a new console application

docs/core/extensions/queue-service.md

@@ -23,7 +23,7 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet/8.0)
+- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet)
 - A .NET integrated development environment (IDE)
   - Feel free to use [Visual Studio](https://visualstudio.microsoft.com)
 

docs/core/extensions/scoped-service.md

@@ -23,7 +23,7 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet/8.0)
+- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet)
 - A .NET integrated development environment (IDE)
   - Feel free to use [Visual Studio](https://visualstudio.microsoft.com)
 

docs/core/extensions/timer-service.md

@@ -23,7 +23,7 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet/8.0)
+- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet)
 - A .NET integrated development environment (IDE)
   - Feel free to use [Visual Studio](https://visualstudio.microsoft.com)
 

docs/core/extensions/windows-service.md

@@ -28,7 +28,7 @@ In this tutorial, you'll learn how to:
 
 ## Prerequisites
 
-- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet/8.0)
+- The [.NET 8.0 SDK or later](https://dotnet.microsoft.com/download/dotnet)
 - A Windows OS
 - A .NET integrated development environment (IDE)
   - Feel free to use [Visual Studio](https://visualstudio.microsoft.com)

docs/core/install/windows.md

@@ -167,6 +167,8 @@ For more information about, see [.NET SDK, MSBuild, and Visual Studio versioning
 
 ## Install with Visual Studio Code
 
+This [WinGet script](https://builds.dotnet.microsoft.com/dotnet/install/dotnet_basic_config_docs.winget) installs Visual Studio Code, the C# DevKit and the .NET SDK. Download the script, then double-click to run it. You may need to accept a User Account Control (UAC) prompt.
+
 Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code can use the SDK already installed on your system. Additionally, the [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) extension will install .NET for you if it's not already installed.
 
 For instructions on installing .NET through Visual Studio Code, see [Getting Started with C# in VS Code](https://code.visualstudio.com/docs/csharp/get-started).

docs/core/porting/upgrade-assistant-install.md

@@ -18,7 +18,7 @@ This article teaches you how to install .NET Upgrade Assistant using either the
 
 - Windows Operating System
 - [Visual Studio 2022 version 17.1 or newer](https://visualstudio.microsoft.com/downloads/).
-- [.NET SDK 8 or later](https://dotnet.microsoft.com/download/dotnet/).
+- [.NET SDK](https://dotnet.microsoft.com/download/dotnet/).
 
 ## Methods
 

docs/core/testing/unit-testing-fsharp-with-nunit.md

@@ -14,8 +14,7 @@ This tutorial takes you through an interactive experience building a sample solu
 
 ## Prerequisites
 
-- [.NET 8 SDK](https://dotnet.microsoft.com/download) or later versions.
-- A text editor or code editor of your choice.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ## Create the source project
 

docs/core/testing/unit-testing-visual-basic-with-nunit.md

@@ -12,8 +12,7 @@ This tutorial takes you through an interactive experience building a sample solu
 
 ## Prerequisites
 
-- [.NET 8 SDK](https://dotnet.microsoft.com/download) or later versions.
-- A text editor or code editor of your choice.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ## Creating the source project
 

docs/core/testing/unit-testing-with-mstest.md

@@ -13,7 +13,7 @@ This tutorial takes you through an interactive experience building a sample solu
 
 ## Prerequisites
 
-* The [.NET 6.0 SDK or later](https://dotnet.microsoft.com/download)
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ## Create the source project
 

docs/core/testing/unit-testing-with-nunit.md

@@ -13,8 +13,7 @@ This tutorial takes you through an interactive experience building a sample solu
 
 ## Prerequisites
 
-- [.NET 8.0](https://dotnet.microsoft.com/download) or later versions.
-- A text editor or code editor of your choice.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ## Creating the source project
 

docs/core/tools/global-tools-how-to-create.md

@@ -17,11 +17,7 @@ This is the first in a series of three tutorials. In this tutorial, you create a
 
 ## Prerequisites
 
-- [.NET SDK 6.0.100](https://dotnet.microsoft.com/download/dotnet/6.0) or a later version.
-
-  This tutorial uses .NET SDK 6.0, but global tools are available starting in .NET Core SDK 2.1. Local tools are available starting in .NET Core SDK 3.0.
-
-- A text editor or code editor of your choice.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ## Create a project
 

docs/core/tutorials/creating-app-with-plugin-support.md

@@ -20,7 +20,7 @@ This tutorial shows you how to create a custom <xref:System.Runtime.Loader.Assem
 
 ## Prerequisites
 
-- Install the [.NET SDK](https://dotnet.microsoft.com/download).
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ## Create the application
 

docs/core/tutorials/libraries.md

@@ -10,7 +10,7 @@ This article covers how to write libraries for .NET using the .NET CLI. The CLI
 
 ## Prerequisites
 
-You need the [.NET SDK](https://dotnet.microsoft.com/download) installed on your machine.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 For the sections of this document dealing with .NET Framework versions, you need the [.NET Framework](https://dotnet.microsoft.com/download/dotnet-framework) installed on a Windows machine.
 

docs/core/tutorials/library-with-visual-studio-code.md

@@ -13,11 +13,9 @@ When you create a class library, you can distribute it as a third-party componen
 
 ## Prerequisites
 
-* [Visual Studio Code](https://code.visualstudio.com/) with [C# Dev Kit extension](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) installed.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
-  For information about how to install extensions on Visual Studio Code, see [VS Code Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery).
-
-* The [.NET 9 SDK](https://dotnet.microsoft.com/download/dotnet/9.0).
+For information about how to install extensions on Visual Studio Code, see [VS Code Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery).
 
 ## Create a class library project
 

docs/core/tutorials/testing-with-cli.md

@@ -42,7 +42,7 @@ Projects that logically group files into folders are easy to navigate and mainta
 
 ### Prerequisites
 
-* [.NET 5.0 SDK](https://dotnet.microsoft.com/download) or a later version.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ### Building the sample
 

docs/core/tutorials/with-visual-studio-code.md

@@ -9,11 +9,9 @@ This tutorial shows how to create and run a .NET console application by using Vi
 
 ## Prerequisites
 
-* [Visual Studio Code](https://code.visualstudio.com/) with [C# Dev Kit](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csdevkit) installed.
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
-  For information about how to install extensions on Visual Studio Code, see [VS Code Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery).
-
-* The [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0).
+For information about how to install extensions on Visual Studio Code, see [VS Code Extension Marketplace](https://code.visualstudio.com/docs/editor/extension-gallery).
 
 ## Create the app
 

docs/csharp/advanced-topics/interface-implementation/default-interface-methods-versions.md

@@ -17,7 +17,7 @@ In this tutorial, you'll learn how to:
 
 ## Prerequisites
 
-You need to set up your machine to run .NET, including the C# compiler. The C# compiler is available with [Visual Studio 2022](https://visualstudio.microsoft.com/downloads) or the [.NET SDK](https://dotnet.microsoft.com/download).
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
 
 ## Scenario overview
 

docs/csharp/advanced-topics/interface-implementation/mixins-with-default-interface-methods.md

@@ -17,7 +17,7 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-You need to set up your machine to run .NET, including the C# compiler. The C# compiler is available with [Visual Studio 2022](https://visualstudio.microsoft.com/downloads), or the [.NET SDK](https://dotnet.microsoft.com/download/dotnet).
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
 
 ## Limitations of extension methods
 

docs/csharp/advanced-topics/performance/interpolated-string-handler.md

@@ -16,7 +16,7 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-You need to set up your machine to run .NET. The C# compiler is available with [Visual Studio 2022](https://visualstudio.microsoft.com/downloads/) or the [.NET SDK](https://dotnet.microsoft.com/download).
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
 
 This tutorial assumes you're familiar with C# and .NET, including either Visual Studio or the .NET CLI.
 

docs/csharp/advanced-topics/reflection-and-attributes/attribute-tutorial.md

@@ -13,7 +13,7 @@ In this tutorial, you learn how to add attributes to your code, how to create an
 
 ## Prerequisites
 
-You need to set up your machine to run .NET. You can find the installation instructions on the [.NET Downloads](https://dotnet.microsoft.com/download) page. You can run this application on Windows, Ubuntu Linux, macOS, or in a Docker container. You need to install your favorite code editor. The following descriptions use [Visual Studio Code](https://code.visualstudio.com), which is an open-source, cross-platform editor. However, you can use whatever tools you're comfortable with.
+[!INCLUDE [Prerequisites](../../../../includes/dotnet-prerequisites.md)]
 
 ## Create the app
 

docs/csharp/asynchronous-programming/cancel-an-async-task-or-a-list-of-tasks.md

@@ -19,11 +19,7 @@ This tutorial covers:
 
 ## Prerequisites
 
-This tutorial requires the following:
-
-- [.NET 5 or later SDK](https://dotnet.microsoft.com/download/dotnet/5.0)
-- Integrated development environment (IDE)
-  - [We recommend Visual Studio or Visual Studio Code](https://visualstudio.microsoft.com)
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ### Create example application
 

docs/csharp/asynchronous-programming/cancel-async-tasks-after-a-period-of-time.md

@@ -20,12 +20,7 @@ This tutorial covers:
 
 ## Prerequisites
 
-This tutorial requires the following:
-
-- You're expected to have created an application in the [Cancel a list of tasks (C#)](cancel-an-async-task-or-a-list-of-tasks.md) tutorial
-- [.NET 5 or later SDK](https://dotnet.microsoft.com/download/dotnet/5.0)
-- Integrated development environment (IDE)
-  - [We recommend Visual Studio or Visual Studio Code](https://visualstudio.microsoft.com)
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 ## Update application entry point
 

docs/csharp/asynchronous-programming/generate-consume-asynchronous-stream.md

@@ -19,7 +19,7 @@ In this tutorial, you'll learn how to:
 
 ## Prerequisites
 
-You'll need to set up your machine to run .NET, including the C# compiler. The C# compiler is available with [Visual Studio 2022](https://visualstudio.microsoft.com/downloads) or the [.NET SDK](https://dotnet.microsoft.com/download).
+[!INCLUDE [Prerequisites](../../../includes/dotnet-prerequisites.md)]
 
 You'll need to create a [GitHub access token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/#creating-a-token) so that you can access the GitHub GraphQL endpoint. Select the following permissions for your GitHub Access Token: