From bb76b84a621884f365b1601a0072db89a0f54e4e Mon Sep 17 00:00:00 2001 From: Taylor Southwick Date: Tue, 23 Sep 2025 13:48:28 -0700 Subject: [PATCH 1/5] Highlight that GHCP migration support for framework apps is in preview --- .../github-copilot-app-modernization-overview.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index 53082daab9250..dc5b1b46d3eca 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -59,7 +59,6 @@ Feedback is important to Microsoft and the efficiency of this agent. Use the [Su The modernization agent supports upgrading projects coded in C#. The following types of projects are supported: -- ASP.NET and related technologies such as MVC, Razor Pages, Web API - Blazor - Azure Functions - Windows Presentation Foundation @@ -67,6 +66,11 @@ The modernization agent supports upgrading projects coded in C#. The following t - Class libraries - Console apps +> [!WARNING] +> ASP.NET and related technologies such as MVC, Razor Pages, Web API are still in preview. You may use the tool to attempt +> upgrading these, but be aware it will only work for limited scenarios. Please see [ASP.NET Migration](~/aspnet/core/migration/fx-to-core) +> for details on recommendations for these kinds of migrations. + To learn how to start an upgrade, see [How to upgrade a .NET app with GitHub Copilot app modernization](how-to-upgrade-with-github-copilot.md). ### Upgrade paths @@ -74,10 +78,12 @@ To learn how to start an upgrade, see [How to upgrade a .NET app with GitHub Cop The following upgrade paths are supported: - Upgrade projects from older .NET versions to the latest. -- Upgrade projects from .NET Framework to the latest version of .NET. - Modernize your code base with new features. - Migrate components and services to Azure. +> [!WARNING] +> Upgrading projects from .NET Framework to the latest version of .NET is still in preview. + ## Migrate .NET projects to Azure The modernization agent combines automated analysis, AI-driven code remediation, build and vulnerability checks, and deployment automation to simplify migrations to Azure. The following capabilities describe how the agent assesses readiness, applies fixes, and streamlines the migration process: From be25a21bd50b6c6803358e1f9686744558a310ee Mon Sep 17 00:00:00 2001 From: Taylor Southwick Date: Tue, 23 Sep 2025 14:06:06 -0700 Subject: [PATCH 2/5] Fix broken link --- docs/core/porting/github-copilot-app-modernization-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index dc5b1b46d3eca..6a8080b19cf24 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -68,7 +68,7 @@ The modernization agent supports upgrading projects coded in C#. The following t > [!WARNING] > ASP.NET and related technologies such as MVC, Razor Pages, Web API are still in preview. You may use the tool to attempt -> upgrading these, but be aware it will only work for limited scenarios. Please see [ASP.NET Migration](~/aspnet/core/migration/fx-to-core) +> upgrading these, but be aware it will only work for limited scenarios. Please see [ASP.NET Migration](/aspnet/core/migration/fx-to-core) > for details on recommendations for these kinds of migrations. To learn how to start an upgrade, see [How to upgrade a .NET app with GitHub Copilot app modernization](how-to-upgrade-with-github-copilot.md). From 77bc9719f465bd1a1cb39c8cf7d4c896c45b8ed3 Mon Sep 17 00:00:00 2001 From: Taylor Southwick Date: Tue, 23 Sep 2025 14:16:35 -0700 Subject: [PATCH 3/5] change warning to note --- .../core/porting/github-copilot-app-modernization-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index 6a8080b19cf24..e6d871ee5f455 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -66,7 +66,7 @@ The modernization agent supports upgrading projects coded in C#. The following t - Class libraries - Console apps -> [!WARNING] +> [!NOTE] > ASP.NET and related technologies such as MVC, Razor Pages, Web API are still in preview. You may use the tool to attempt > upgrading these, but be aware it will only work for limited scenarios. Please see [ASP.NET Migration](/aspnet/core/migration/fx-to-core) > for details on recommendations for these kinds of migrations. @@ -81,7 +81,7 @@ The following upgrade paths are supported: - Modernize your code base with new features. - Migrate components and services to Azure. -> [!WARNING] +> [!NOTE] > Upgrading projects from .NET Framework to the latest version of .NET is still in preview. ## Migrate .NET projects to Azure From 0ec254592064cafbed4badbd55d5676e376bc291 Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 30 Sep 2025 12:59:30 -0700 Subject: [PATCH 4/5] Update docs/core/porting/github-copilot-app-modernization-overview.md --- .../core/porting/github-copilot-app-modernization-overview.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index 5f3efb57f34e7..d85998eb01e8d 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -64,9 +64,7 @@ The modernization agent supports upgrading projects coded in C#. The following t - Console apps > [!NOTE] -> ASP.NET and related technologies such as MVC, Razor Pages, Web API are still in preview. You may use the tool to attempt -> upgrading these, but be aware it will only work for limited scenarios. Please see [ASP.NET Migration](/aspnet/core/migration/fx-to-core) -> for details on recommendations for these kinds of migrations. +> .NET Framework update scenarios are currently in preview. Using the modernization agent to design an upgrade plan might work in limited scenarios. If upgrading an ASP.NET project (or related technologies such as MVC, Razor Pages, Web API) see [ASP.NET Migration](/aspnet/core/migration/fx-to-core) for recommendations. To learn how to start an upgrade, see [How to upgrade a .NET app with GitHub Copilot app modernization](how-to-upgrade-with-github-copilot.md). From 5f0d9a4e863fbff21aa6d75484a1afa4d92c326d Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 30 Sep 2025 13:01:51 -0700 Subject: [PATCH 5/5] Revise .NET upgrade notes and emphasize ASP.NET migration Updated notes on .NET Framework upgrade scenarios and added emphasis on ASP.NET project migration recommendations. --- .../porting/github-copilot-app-modernization-overview.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization-overview.md b/docs/core/porting/github-copilot-app-modernization-overview.md index d85998eb01e8d..a485a4cf16514 100644 --- a/docs/core/porting/github-copilot-app-modernization-overview.md +++ b/docs/core/porting/github-copilot-app-modernization-overview.md @@ -56,6 +56,7 @@ To start an upgrade or migration, interact with GitHub Copilot, following these The modernization agent supports upgrading projects coded in C#. The following types of projects are supported: +- ASP.NET Core (and related technologies such as MVC, Razor Pages, and Web API) - Blazor - Azure Functions - Windows Presentation Foundation @@ -63,8 +64,8 @@ The modernization agent supports upgrading projects coded in C#. The following t - Class libraries - Console apps -> [!NOTE] -> .NET Framework update scenarios are currently in preview. Using the modernization agent to design an upgrade plan might work in limited scenarios. If upgrading an ASP.NET project (or related technologies such as MVC, Razor Pages, Web API) see [ASP.NET Migration](/aspnet/core/migration/fx-to-core) for recommendations. +> [!IMPORTANT] +> .NET Framework upgrade scenarios are currently in preview, which includes technologies such as Windows Forms for .NET Framework and ASP.NET. Using the modernization agent to design an upgrade plan might work in limited scenarios. If upgrading an ASP.NET project (or related technologies such as MVC, Razor Pages, Web API) see [ASP.NET Migration](/aspnet/core/migration/fx-to-core) for recommendations. To learn how to start an upgrade, see [How to upgrade a .NET app with GitHub Copilot app modernization](how-to-upgrade-with-github-copilot.md). @@ -76,7 +77,7 @@ The following upgrade paths are supported: - Modernize your code base with new features. - Migrate components and services to Azure. -> [!NOTE] +> [!IMPORTANT] > Upgrading projects from .NET Framework to the latest version of .NET is still in preview. ## Migrate .NET projects to Azure