Skip to content

Commit 2c652b5

Browse files
adegeogewarren
andauthored
Minor changes to Windows install article (#43022)
* rework intro; remove .msi file reference * Apply suggestions from code review Thanks gewarren! Co-authored-by: Genevieve Warren <[email protected]> --------- Co-authored-by: Genevieve Warren <[email protected]>
1 parent b429147 commit 2c652b5

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

docs/core/install/windows.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "Learn about which versions of .NET SDK and .NET Runtime are suppor
44
author: adegeo
55
ms.author: adegeo
66
ms.topic: install-set-up-deploy #Don't change
7-
ms.date: 05/15/2024
7+
ms.date: 10/10/2024
88
#customer intent: As a developer or user, I want to decide the best way to install .NET on Windows.
99
---
1010

@@ -16,30 +16,30 @@ ms.date: 05/15/2024
1616
> - [Install on macOS](macos.md)
1717
> - [Install on Linux](linux.md)
1818
19-
There are many different ways to install .NET on Windows. This article helps you understand the difference between the SDK and Runtime, which runtime you should install, and the method you should use to install .NET.
19+
This article teaches you about which versions of .NET are supported on Windows, how to install .NET, and what the difference is between the SDK and runtime.
2020

21-
.NET is made up of the runtime and the SDK. The runtime runs .NET apps, and the SDK is used to create apps.
21+
Unlike .NET Framework, .NET isn't tied to your version of Windows. You can only have a single version of .NET Framework installed on Windows. But .NET is standalone and can be installed anywhere on your computer. Some apps might include their own copy of .NET.
2222

23-
Unlike .NET Framework, .NET isn't installed and tied to your version of Windows. You can only have a single version of .NET Framework installed on Windows. .NET can be installed anywhere on your computer and some apps might include their own copy of .NET.
23+
By default, .NET is installed to the _Program Files\\dotnet_ directory on your computer, unless the installation method chooses a different directory.
2424

25-
By default, .NET is installed to the _Program Files\\dotnet_ directory on your computer, unless the install method chooses a different directory.
25+
.NET is made up of the runtime and the SDK. The runtime runs .NET apps, and the SDK is used to create apps.
2626

2727
## Choose the correct runtime
2828

29-
There are three different runtimes for Windows, which enable different types of apps to run. The SDK includes all three runtimes. If you install a specific runtime, it might include other runtimes. The following table describes which runtime is included with a particular .NET installer:
29+
There are three different runtimes for Windows, which enable different types of apps to run. The SDK includes all three runtimes, and an installer for a runtime might include an additional runtime. The following table describes which runtime is included with a particular .NET installer:
3030

31-
| | Includes .NET Runtime | Includes .NET Desktop Runtime | Includes ASP.NET Core Runtime |
31+
| Installer | Includes .NET Runtime | Includes .NET Desktop Runtime | Includes ASP.NET Core Runtime |
3232
| ------------------------ | ----------------------------- | ----------------------------- | ----------------------------- |
3333
| **.NET Runtime** | Yes | No | No |
3434
| **.NET Desktop Runtime** | Yes | Yes | No |
3535
| **ASP.NET Core Runtime** | No | No | Yes |
3636
| **.NET SDK** | Yes | Yes | Yes |
3737

38-
To ensure that you can run all .NET apps on Windows, install both the ASP.NET Core Runtime and the .NET Desktop Runtime. The ASP.NET Core Runtime runs any web apps, and the .NET Desktop Runtime runs any desktop app, such as a Windows Presentation Foundation (WPF) or Windows Forms (WinForms) app.
38+
To ensure that you can run all .NET apps on Windows, install both the ASP.NET Core Runtime and the .NET Desktop Runtime. The ASP.NET Core Runtime runs web-based apps, and the .NET Desktop Runtime runs desktop apps, such as a Windows Presentation Foundation (WPF) or Windows Forms app.
3939

4040
## Choose how to install .NET
4141

42-
There are different ways to install .NET, and some products, like Visual Studio, might manage their own version of .NET. If you install .NET through software that manages its own version of .NET, you should also install the .NET runtime separately so that you can run .NET apps.
42+
There are different ways to install .NET, and some products might manage their own version of .NET. If you install .NET through software that manages its own version of .NET, it might not be enabled system-wide. Make sure you understand the implications of installing .NET through other software.
4343

4444
If you're unsure which method you should choose after reviewing the lists in the following sections, you probably want to use the [.NET Installer](#net-installer).
4545

@@ -203,7 +203,7 @@ The [download page](https://dotnet.microsoft.com/download/dotnet) for .NET provi
203203
1. Find the SDK or Runtime box that contains the links for downloading .NET.
204204
1. Under the **Installers** column, find the **Windows** row and select the link for your CPU architecture. If you're unsure, select **x64** as it's the most common.
205205

206-
The browser automatically downloads the MSI package.
206+
The browser should automatically download the installer.
207207

208208
> [!TIP]
209209
> The following image shows the SDK, but you can also download the Runtime.
@@ -215,15 +215,17 @@ The [download page](https://dotnet.microsoft.com/download/dotnet) for .NET provi
215215

216216
The Windows Installer dialog is opened.
217217

218-
:::image type="content" source="media/windows/msi-installer.png" alt-text="A screenshot of the .NET MSI installer app window.":::
218+
:::image type="content" source="media/windows/msi-installer.png" alt-text="A screenshot of the .NET installer app window.":::
219219

220220
1. Select **Install** and follow the instructions to install .NET.
221221

222222
To learn how to use the .NET CLI, see [.NET CLI overview](../tools/index.md).
223223

224224
### Command-line options
225225

226-
If you want to install .NET silently, such as in a production environment or to support continuous integration, use the following Windows Installer options:
226+
Use the `/?` parameter to display a list of options.
227+
228+
If you want to install .NET silently, such as in a production environment or to support continuous integration, use the following options:
227229

228230
- `/install`\
229231
Installs .NET.
@@ -238,8 +240,6 @@ Suppresses any attempts to restart.
238240
dotnet-sdk-8.0.100-win-x64.exe /install /quiet /norestart
239241
```
240242

241-
For more information, see [Standard Installer Command-Line Options](/windows/win32/msi/standard-installer-command-line-options).
242-
243243
> [!TIP]
244244
> The installer returns an exit code of **0** for success and an exit code of **3010** to indicate that a restart is required. Any other value is most likely an error code.
245245
@@ -261,7 +261,7 @@ The .NET WinGet packages are:
261261
If you install the SDK, you don't need to install the corresponding runtime.
262262

263263
01. [Install WinGet](/windows/package-manager/winget/#install-winget).
264-
01. Open a terminal, such as PowerShell or `cmd.exe`.
264+
01. Open a terminal, such as PowerShell or Command Prompt.
265265
01. Run the `winget install` command and pass the name of the SDK package:
266266

267267
```cmd

0 commit comments

Comments
 (0)