Simplify framework install docs (#44900)

* Simplify framework install docs

* Build errors; Fix image/code links

* Convert and clean code for .NET Framework

* Add snippets config

* Fix links to moved files

* Fix remaining links

* Add start icon to instruction

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Final updates

---------

Co-authored-by: Genevieve Warren <[email protected]>

Author: adegeo

.openpublishing.redirection.framework.json

@@ -926,15 +926,15 @@
         },
         {
             "source_path_from_root": "/docs/framework/deployment/windows/10.md",
-            "redirect_url": "/dotnet/framework/install/on-windows-10"
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
         },
         {
             "source_path_from_root": "/docs/framework/deployment/windows/7.md",
             "redirect_url": "/previous-versions/dotnet/framework/install/on-windows-7"
         },
         {
             "source_path_from_root": "/docs/framework/deployment/windows/8.md",
-            "redirect_url": "/dotnet/framework/install/on-windows-8"
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
         },
         {
             "source_path_from_root": "/docs/framework/deployment/windows/index.md",
@@ -985,6 +985,34 @@
             "redirect_url": "/previous-versions/dotnet/framework/install/on-windows-7",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/docs/framework/install/on-windows-8.md",
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
+        },
+        {
+            "source_path_from_root": "/docs/framework/install/on-windows-8-1.md",
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
+        },
+        {
+            "source_path_from_root": "/docs/framework/install/on-windows-10.md",
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
+        },
+        {
+            "source_path_from_root": "/docs/framework/install/on-windows-11.md",
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
+        },
+        {
+            "source_path_from_root": "/docs/framework/install/on-server-2019.md",
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
+        },
+        {
+            "source_path_from_root": "/docs/framework/install/on-server-2022.md",
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
+        },
+        {
+            "source_path_from_root": "/docs/framework/install/on-server-2025.md",
+            "redirect_url": "/dotnet/framework/install/on-windows-and-server"
+        },
         {
             "source_path_from_root": "/docs/framework/install/on-windows-vista.md",
             "redirect_url": "/previous-versions/dotnet/framework/install/on-windows-vista",
@@ -995,6 +1023,10 @@
             "redirect_url": "/previous-versions/dotnet/framework/install/on-windows-xp",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/docs/framework/install/run-net-framework-1-1-apps.md",
+            "redirect_url": "/dotnet/framework/install/dotnet-35-windows"
+        },
         {
             "source_path_from_root": "/docs/framework/interop/applying-interop-attributes.md",
             "redirect_url": "/dotnet/standard/native-interop/apply-interop-attributes",
@@ -1113,6 +1145,14 @@
             "source_path_from_root": "/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-7.md",
             "redirect_url": "/dotnet/framework/migration-guide/application-compatibility"
         },
+        {
+            "source_path_from_root": "/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md",
+            "redirect_url": "/dotnet/framework/install/how-to-determine-which-versions-are-installed"
+        },
+        {
+            "source_path_from_root": "/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md",
+            "redirect_url": "/dotnet/framework/install/how-to-determine-which-net-framework-updates-are-installed"
+        },
         {
             "source_path_from_root": "/docs/framework/migration-guide/migration-guide/mitigation-culture-and-asynchronous-operations.md",
             "redirect_url": "/dotnet/framework/migration-guide/retargeting/4.6.x"
@@ -1151,7 +1191,7 @@
         },
         {
             "source_path_from_root": "/docs/framework/migration-guide/minimum-release-dword.md",
-            "redirect_url": "/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed"
+            "redirect_url": "/dotnet/framework/install/how-to-determine-which-versions-are-installed"
         },
         {
             "source_path_from_root": "/docs/framework/migration-guide/mitigation-claimsidentity-constructor.md",
@@ -1167,7 +1207,7 @@
         },
         {
             "source_path_from_root": "/docs/framework/migration-guide/release-keys-and-os-versions.md",
-            "redirect_url": "/dotnet/framework/migration-guide/how-to-determine-which-versions-are-installed"
+            "redirect_url": "/dotnet/framework/install/how-to-determine-which-versions-are-installed"
         },
         {
             "source_path_from_root": "/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-1.md",
@@ -1673,6 +1713,10 @@
             "source_path_from_root": "/docs/framework/migration-guide/runtime/index.md",
             "redirect_url": "/dotnet/framework/migration-guide/application-compatibility"
         },
+        {
+            "source_path_from_root": "/docs/framework/migration-guide/versions-and-dependencies.md",
+            "redirect_url": "/dotnet/framework/install/versions-and-dependencies"
+        },
         {
             "source_path_from_root": "/docs/framework/misc/binding.md",
             "redirect_url": "/dotnet/framework/configure-apps/file-schema/wcf/bindings"

docs/core/install/how-to-detect-installed-versions.md

@@ -197,4 +197,4 @@ You can see both the SDK versions and runtime versions with the command `dotnet
 
 ## See also
 
-- [Determine which .NET Framework versions are installed](../../framework/migration-guide/how-to-determine-which-versions-are-installed.md)
+- [Determine which .NET Framework versions are installed](../../framework/install/how-to-determine-which-versions-are-installed.md)

docs/csharp/language-reference/compiler-options/index.md

@@ -58,4 +58,4 @@ For .NET Framework projects, you can also run *csc.exe* from the command line. E
 
 If you use the **Developer Command Prompt for Visual Studio** window, all the necessary environment variables are set for you. For information on how to access this tool, see [Developer Command Prompt for Visual Studio](/visualstudio/ide/reference/command-prompt-powershell).
 
-The *csc.exe* executable file is usually located in the Microsoft.NET\Framework\\*\<Version>* folder under the *Windows* directory. Its location might vary depending on the exact configuration of a particular computer. If more than one version of .NET Framework is installed on your computer, you'll find multiple versions of this file. For more information about such installations, see [How to: determine which versions of the .NET Framework are installed](../../../framework/migration-guide/how-to-determine-which-versions-are-installed.md).
+The *csc.exe* executable file is usually located in the Microsoft.NET\Framework\\*\<Version>* folder under the *Windows* directory. Its location might vary depending on the exact configuration of a particular computer. If more than one version of .NET Framework is installed on your computer, you'll find multiple versions of this file. For more information about such installations, see [How to: determine which versions of the .NET Framework are installed](../../../framework/install/how-to-determine-which-versions-are-installed.md).

docs/framework/deployment/index.md

@@ -63,9 +63,9 @@ Use the following links to other MSDN topics for specific information about depl
 
 - For general information, see the [.NET Framework blog](https://devblogs.microsoft.com/dotnet/).
 
-- [Detecting versions](../migration-guide/how-to-determine-which-versions-are-installed.md)
+- [Detecting versions](../install/how-to-determine-which-versions-are-installed.md)
 
-- [Detecting service packs and updates](../migration-guide/how-to-determine-which-net-framework-updates-are-installed.md)
+- [Detecting service packs and updates](../install/how-to-determine-which-net-framework-updates-are-installed.md)
 
 ## Features That Simplify Deployment
 

docs/framework/get-started/index.md

@@ -45,7 +45,7 @@ In general, you shouldn't uninstall versions of .NET Framework that are installe
 
 - If an app that you use depends on a specific version of .NET Framework, that app may break if that version is removed.
 
-- Some versions of .NET Framework are in-place updates to earlier versions. For example, .NET Framework 3.5 is an in-place update to version 2.0, and .NET Framework 4.8 is an in-place update to versions 4 through 4.7.2. For more information, see [.NET Framework Versions and Dependencies](../migration-guide/versions-and-dependencies.md).
+- Some versions of .NET Framework are in-place updates to earlier versions. For example, .NET Framework 3.5 is an in-place update to version 2.0, and .NET Framework 4.8 is an in-place update to versions 4 through 4.7.2. For more information, see [.NET Framework Versions and Dependencies](../install/versions-and-dependencies.md).
 
 On Windows versions before Windows 8, if you do choose to remove .NET Framework, always use **Programs and Features** from Control Panel to uninstall it. Never remove a version of .NET Framework manually. On Windows 8 and above, .NET Framework is an operating system component and cannot be independently uninstalled.
 

docs/framework/get-started/system-requirements.md

@@ -17,7 +17,7 @@ The tables in this article provide the hardware, operating system, and software
 - .NET Framework 4.7 and its point releases (4.7.1 and 4.7.2).
 - .NET Framework 4.6.2.
 
-For information on earlier .NET Framework versions, see [.NET Framework versions and dependencies](../migration-guide/versions-and-dependencies.md).
+For information on earlier .NET Framework versions, see [.NET Framework versions and dependencies](../install/versions-and-dependencies.md).
 
 Development environments that enable you to develop apps for .NET Framework have a separate set of requirements.
 

docs/framework/install/dotnet-35-windows.md

@@ -1,43 +1,73 @@
 ---
-title: Install .NET Framework 3.5 on Windows 11, 10, 8.1, 8
-description: Learn how to install the .NET Framework 3.5 on Windows 11, Windows 10, Windows 8.1, and Windows 8.
-ms.date: 10/06/2021
+title: Install .NET Framework 3.5 on Windows
+description: Learn how to install .NET Framework 3.5 on Windows and Windows Server. .NET Framework 3.5 can run apps that target .NET Framework 1.0 through 3.5.
+ms.date: 02/10/2025
 ---
-# Install .NET Framework 3.5 on Windows 11, Windows 10, Windows 8.1, and Windows 8
+# Install .NET Framework 3.5 on Windows and Windows Server
 
-You may need the .NET Framework 3.5 to run an app on Windows 11, Windows 10, Windows 8.1, and Windows 8. You can also use these instructions for earlier Windows versions.
+You might need .NET Framework 3.5 to run an app on Windows or Windows Server. Windows and Windows Server come with .NET Framework 4, which doesn't support apps built with .NET Framework 1.1 through 3.5. To run these apps, install .NET Framework 3.5. If you're a developer that requires .NET Framework 3.5, see the section [Developers and .NET Framework 3.5](#developers-and-net-framework-35).
 
-## Install .NET Framework 3.5 on Demand
+> [!TIP]
+> You might be able to use a config file to force the app to run on .NET Framework 4. For more information, see [Migration: Retarget or Recompile](../migration-guide/migrating-from-the-net-framework-1-1.md#retarget-or-recompile).
 
-You may see the following configuration dialog if you try to run an app that requires .NET Framework 3.5. Choose **Install this feature** to enable .NET Framework 3.5. This option requires an Internet connection.
+## Install .NET Framework 3.5 on demand
 
-![Screenshot of the .NET Framework installation dialog.](./media/dotnet-35-windows/dotnet-framework-installation-dialog.png)
+You might see the following configuration dialog if you try to run an app that requires an older version of .NET Framework. Depending on your version of Windows, the dialog might be slightly different. Choose **Download and install this feature** to enable .NET Framework 3.5. This option requires an internet connection.
+
+:::image type="content" source="./media/dotnet-35-windows/dotnet-framework-installation-dialog.png" alt-text="Screenshot of the .NET Framework installation dialog.":::
 
 ### Why am I getting this pop-up?
 
-The .NET Framework is created by Microsoft and provides an environment for running applications. There are different versions available. Many companies develop their apps to run using the .NET Framework, and these apps target a specific version. If you see this pop-up, you're trying to run an application that requires .NET Framework version 3.5, but that version is not installed on your system.
+.NET Framework is created by Microsoft and provides an environment for running apps. There are different versions available. Many companies develop their apps to run using the .NET Framework, and these apps target a specific version. If you see this pop-up, you're trying to run an app that requires a .NET Framework version that isn't installed on your system.
+
+## Enable .NET Framework 3.5 on Windows Server
+
+Enable .NET Framework 3.5 through the **Add Roles and Features Wizard**.
 
-## Enable .NET Framework 3.5 in Control Panel
+1. Press the Start :::image type="icon" source="media/dotnet-35-windows/windows-keyboard-logo.png" border="false"::: button on the taskbar.
+1. Search for **Add Roles and Features Wizard** and open it.
+1. Search for **Windows Features** and open it. The **Turn Windows features on or off** dialog box appears.
+1. Navigate through the wizard until you reach **Features**.
+1. Select **.NET Framework 3.5 Features** in the list.
+1. Select **Install** to start installing .NET Framework 3.5.
 
-You can enable the .NET Framework 3.5 through the Windows Control Panel. This option requires an Internet connection.
+:::image type="content" source="media/dotnet-35-windows/server-features.png" alt-text="The Add Roles and Features Wizard dialog box from Windows Server. .NET Framework 3.5 is selected.":::
 
-1. Press the Windows key ![Screenshot of the Windows key logo.](./media/dotnet-35-windows/windows-keyboard-logo.png) on your keyboard, type "Windows Features", and press Enter. The **Turn Windows features on or off** dialog box appears.
+## Enable .NET Framework 3.5 on Windows
 
-2. Select the **.NET Framework 3.5 (includes .NET 2.0 and 3.0)** check box, select **OK**, and reboot your computer if prompted.
+You can enable the .NET Framework 3.5 through the Windows Control Panel. This option requires an internet connection.
 
-   ![Screenshot showing installation of .NET with the control panel.](./media/dotnet-35-windows/dotnet-control-panel.png)
+1. Press the Start :::image type="icon" source="media/dotnet-35-windows/windows-keyboard-logo.png" border="false"::: button on the taskbar.
+1. Search for **Windows Features** and open it. The **Turn Windows features on or off** dialog box appears.
+1. Select the **.NET Framework 3.5 (includes .NET 2.0 and 3.0)** check box, select **OK**, and reboot your computer if prompted.
 
-   You don't need to select the child items for **Windows Communication Foundation (WCF) HTTP Activation** and **Windows Communication Foundation (WCF) Non-HTTP Activation** unless you're a developer or server administrator who requires this functionality.
+:::image type="content" source="media/dotnet-35-windows/dotnet-control-panel.png" alt-text="Screenshot of the Windows Features dialog box. .NET Framework 3.5 is selected.":::
+
+You don't need to select the child items for **Windows Communication Foundation (WCF) HTTP Activation** and **Windows Communication Foundation (WCF) Non-HTTP Activation** unless you're a developer or server administrator who requires this functionality.
 
 ## Download the offline installer
 
-For Windows versions prior to Windows 10, the .NET Framework 3.5 SP1 offline installer is available on the [.NET Framework 3.5 SP1 Download page](https://dotnet.microsoft.com/download/dotnet-framework/net35-sp1?wt.mc_id=install-docs).
+The .NET Framework 3.5 SP1 offline installer is available for Windows versions prior to Windows 10 and Windows Server 2016. For more information, see [.NET Framework 3.5 SP1 Download page](https://dotnet.microsoft.com/download/dotnet-framework/net35-sp1?wt.mc_id=install-docs).
 
 ## Troubleshoot the installation
 
-During installation, you may encounter error 0x800f0906, 0x800f0907, 0x800f081f, or 0x800F0922, in which case refer to [.NET Framework 3.5 installation error: 0x800f0906, 0x800f0907, or 0x800f081f](https://support.microsoft.com/help/2734782/net-framework-3-5-installation-error-0x800f0906--0x800f081f--0x800f09) to see how to resolve these issues.
+During installation, you might encounter error **0x800f0906**, **0x800f0907**, **0x800f081f**, or **0x800F0922**, in which case refer to [.NET Framework 3.5 installation error](https://support.microsoft.com/help/2734782/net-framework-3-5-installation-error-0x800f0906--0x800f081f--0x800f09) to see how to resolve these issues.
 
-If you still can't resolve your installation issue or you don't have an Internet connection, you can try installing it using your Windows installation media. For more information, see [Deploy .NET Framework 3.5 by using Deployment Image Servicing and Management (DISM)](/windows-hardware/manufacture/desktop/deploy-net-framework-35-by-using-deployment-image-servicing-and-management--dism). If you're using Windows 7, Windows 8.1, the latest release Windows 10, or Windows 11, but you don't have the installation media, create an up-to-date installation media here: [Create installation media for Windows](https://support.microsoft.com/help/15088/windows-create-installation-media). Additional information about Windows 11 and Windows 10 Features on Demand: [Features on Demand](/windows-hardware/manufacture/desktop/features-on-demand-v2--capabilities).
+If you still can't resolve your installation issue or you don't have an internet connection, you can try installing it using your Windows installation media. For more information, see [Deploy .NET Framework 3.5 by using Deployment Image Servicing and Management (DISM)](/windows-hardware/manufacture/desktop/deploy-net-framework-35-by-using-deployment-image-servicing-and-management--dism). If you don't have the installation media, follow the instructions on [Create installation media for Windows](https://support.microsoft.com/help/15088/windows-create-installation-media). For more information about Windows 11 and Windows 10 Features on Demand, see [Features on Demand](/windows-hardware/manufacture/desktop/features-on-demand-v2--capabilities).
 
 > [!WARNING]
 > If you're not relying on Windows Update as the source for installing .NET Framework 3.5, you must ensure to strictly use sources from the same corresponding Windows operating system version. Using sources from a different Windows operating system version will either install a mismatched version of .NET Framework 3.5 or cause the installation to fail, leaving the system in an unsupported and unserviceable state.
+
+## Developers and .NET Framework 3.5
+
+If you're a developer that maintains existing software and you need to use .NET Framework 3.5, enable it with the following steps:
+
+1. Install .NET Framework 3.5 on your system using the instructions in this article.
+1. Enable **.NET Framework 3.5 Development Tools** in Visual Studio. It's listed in the **Individual Components** page.
+
+## See also
+
+- [Install .NET Framework on Windows and Windows Server](on-windows-and-server.md)
+- [Install .NET Framework for developers](guide-for-developers.md)
+- [How to: Determine which .NET Framework versions are installed](how-to-determine-which-versions-are-installed.md)
+- [Versions and dependencies](versions-and-dependencies.md)