Skip to content

Clean up the ASP.NET Core Overview TOC node #35823

@danroth27

Description

@danroth27

Description

I'd like to clean up and simplify the ASP.NET Core Overview TOC node to focus on new users instead of on migration from ASP.NET & .NET Framework.

Currently the Overview node includes three topics:

I don't want ASP.NET & .NET Framework to appear as options to new users and risk confusing them. I think the only overview doc we need is the Overview of ASP.NET Core doc. The other two need to go away. The Overview node in the ASP.NET Core TOC should just be the Overview of ASP.NET Core article.

Can we retire the "Choose between ASP.NET 4.x and ASP.NET Core" doc? I don't think its content is particularly insightful or helpful. ASP.NET Core is our modern web framework for .NET and is the recommended choice for web development for .NET, but this doc makes it sound like users should evaluate both options. Can we remove the doc and redirect its traffic to the Overview of ASP.NET Core doc? If we need to keep this doc content for some reason, then let's move it somewhere under the ASP.NET to ASP.NET Core migration section.

The ".NET vs. .NET Framework for server" lives in the dotnet doc set and we link to it from the ASP.NET Core docs TOC. I don't think there's any need any more to keep this link and potentially confuse new users with this .NET history lesson. Let's remove the link to this doc from the ASP.NET Core TOC.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/choose-aspnet-framework?view=aspnetcore-9.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/choose-aspnet-framework.md

Document ID

fbc66624-1597-225a-3945-1f16e08ddaec

Platform Id

327e5e65-d1e9-fc1f-e3b8-733b3345529d

Article author

@tdykstra

Metadata

  • ID: 51aecd70-d07a-3e43-0f93-63fc1a4ed1b1
  • PlatformId: 327e5e65-d1e9-fc1f-e3b8-733b3345529d
  • Service: aspnet-core
  • Sub-service: fundamentals

Related Issues

Metadata

Metadata

Assignees

Type

No type

Projects

Status

🏗 In progress

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions