Skip to content

Expand ASP.NET Framework to Core migration #35755

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 20 commits into from
Jul 17, 2025

Conversation

twsouthwick
Copy link
Member

@twsouthwick twsouthwick commented Jul 14, 2025

This change adds more detail and consolidates existing topics to create
a more prescriptive and helpful set of options for developers looking to
migration their ASP.NET Framework to Core applications.

Main things included in this update are:

  • Consolidated topics that were logically connected into a single
    document
  • Added some basic decision trees for developers to understand what is
    most likely to be useful to them
  • Updated the initial landing page to provide a better overview of what
    challenges they may encounter as they start a migration
  • Updated the setup instructions to align with the current state of
    things

Fixes #35755


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
aspnetcore/migration/fx-to-core/areas/authentication.md Migrate ASP.NET Framework Authentication to ASP.NET Core
aspnetcore/migration/fx-to-core/areas/claimsprincipal-current.md Migrate from static ClaimsPrincipal access
aspnetcore/migration/fx-to-core/areas/http-context.md Migrate ASP.NET Framework HttpContext to ASP.NET Core
aspnetcore/migration/fx-to-core/areas/http-handlers.md aspnetcore/migration/fx-to-core/areas/http-handlers
aspnetcore/migration/fx-to-core/areas/http-modules.md Migrate HTTP modules to ASP.NET Core middleware
aspnetcore/migration/fx-to-core/areas/index.md Complex migration scenarios - Deep dive areas
aspnetcore/migration/fx-to-core/areas/membership.md Migrate from ASP.NET Membership authentication to ASP.NET Core 2.0 Identity
aspnetcore/migration/fx-to-core/areas/misc.md aspnetcore/migration/fx-to-core/areas/misc
aspnetcore/migration/fx-to-core/areas/session.md Migrate ASP.NET Framework Session to ASP.NET Core
aspnetcore/migration/fx-to-core/areas/webapi.md [Visual Studio](https://review.learn.microsoft.com/en-us/aspnet/core/migration/fx-to-core/areas/webapi?branch=pr-en-us-35755)
aspnetcore/migration/fx-to-core/inc/ab-testing.md A/B Testing Migrated Endpoints
aspnetcore/migration/fx-to-core/inc/blazor.md Enable ASP.NET Core Blazor Server support with Yarp in incremental migration
aspnetcore/migration/fx-to-core/inc/remote-app-setup.md aspnetcore/migration/fx-to-core/inc/remote-app-setup
aspnetcore/migration/fx-to-core/inc/systemweb-adapters.md System.Web adapters
aspnetcore/migration/fx-to-core/index.md Migrate from ASP.NET Framework to ASP.NET Core
aspnetcore/migration/fx-to-core/start.md Get started with incremental ASP.NET to ASP.NET Core migration
aspnetcore/migration/fx-to-core/tooling.md Use tooling to help migrate ASP.NET Framework to ASP.NET Core
aspnetcore/security/cookie-sharing.md aspnetcore/security/cookie-sharing
aspnetcore/toc.yml aspnetcore/toc
aspnetcore/zone-pivot-groups.yml aspnetcore/zone-pivot-groups

This change adds more detail and consolidates existing topics to create
a more prescriptive and helpful set of options for developers looking to
migration their ASP.NET Framework to Core applications.

Main things included in this update are:

- Consolidated a topics that were logically connected into a single
  document
- Added some basic decision trees for developers to understand what is
  most likely to be useful to them
- Updated the initial landing page to provide a better overview of what
  challenges they may encounter as they start a migration
- Updated the setup instructions to align with the current state of
  things
@guardrex
Copy link
Collaborator

@tdykstra @wadepickett ... I'll have a little time before EOW. Do you want me to review this, or do you want to take care of it?

@wadepickett wadepickett self-assigned this Jul 16, 2025
@wadepickett
Copy link
Contributor

@guardrex and @tdykstra, I just got back from vacation last night. I'll take this one, thanks.

Fixed date to required format with two digits.
Fixed ms.date format which requires 2 digit month
wadepickett and others added 3 commits July 16, 2025 14:22
Just updated ms.date to current since file was significantly updated.
@twsouthwick
Copy link
Member Author

@wadepickett thanks! I've committed those suggestions and updated the ms.date values. let me know if there's more I need to do here

@guardrex
Copy link
Collaborator

I'll remove myself as a reviewer because @wadepickett is taking care of this one.

@guardrex guardrex removed their request for review July 17, 2025 16:35
Copy link
Contributor

@wadepickett wadepickett left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome, thanks @twsouthwick! Looks great.

@wadepickett wadepickett merged commit ab959ee into dotnet:main Jul 17, 2025
3 checks passed
@twsouthwick twsouthwick deleted the aspnet-migration-details branch July 17, 2025 20:30
@guardrex
Copy link
Collaborator

@wadepickett @twsouthwick ... Do you see a "Restore Branch" button in your UI here? I don't see one, but I'm wondering if you do.

@guardrex
Copy link
Collaborator

BTW @twsouthwick ... Your fork's main branch is quite stale ... 8,000 commits behind us ...

https://github.com/twsouthwick/AspNetCore.Docs

@twsouthwick
Copy link
Member Author

@wadepickett @twsouthwick ... Do you see a "Restore Branch" button in your UI here? I don't see one, but I'm wondering if you do.

I deleted it once it was merged

BTW @twsouthwick ... Your fork's main branch is quite stale ... 8,000 commits behind us ...

yeah, I don't use that main branch - I have the upstream branch set to the one from dotnet and just ignore the one on mine

@guardrex
Copy link
Collaborator

In theory, we can still restore that branch to work on it for whatever is breaking the build.

@wadepickett
Copy link
Contributor

wadepickett commented Jul 18, 2025

Sorry, there is no "Restore Branch" button on my end. Yes, it shows deleted after being merged. There was only the option for reverting merge for me.

@wadepickett
Copy link
Contributor

We might want to do these in smaller chunks going forward where possible.

@guardrex
Copy link
Collaborator

Ok ... thought so.

In theory, it can still be done. For now, let's see what effect this has ...

#35775

Probably no effect, but it was a complaint on that PR's build result.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants