Obsolete API warning docs for .NET 10+ on aspnetcore.docs

Aperta
  • Qualcosa non va?
#36,299 1 commento 0 reazioni 1 assegnatario Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@tdykstra ci sta già lavorando.

Dal 1/4/2026.

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

10.0 Pri1 seQUESTered

Obsolete API warnings for ASP.NET Core need to be created in the aspnetcore.docs repo starting with .NET 10 and on.

Currently documentation on diagnostics warning for ASP.NET Core are located here, which also seems like a good location for adding the Obsolete API warnings:
:
https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore/diagnostics

The existing documentation on diagnostics warning for ASP.NET Core uses 3 prefixes, (although a bit cryptic):
They are: asp, bl and mvc
Examples:
https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/diagnostics/asp0028.md
https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/diagnostics/bl0001.md
https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/diagnostics/mvc1000.md

The new one would use the warning ID as the name of the file:
So for warning ID:
ASPDEPR008.md
The file name would be the following which should be lower case:
aspdepr008.md

The TOC lists these under Code Analysis, but we might consider changing that to Compiler Diagnostics instead to fit them all under one description that makes sense.

What exists now:

No prior documents on obsolete API's for the ASP.NET core API's exist at all as their own topics.  They exist in the breaking change documentation and the breaking change issues filed on the source, but it is not available in separate topics which would be much more accessible, folks are directed right the individual warning and what to do for it, rather than a larger breaking changes doc that includes possibly multiple listed obsolete API's.

For this issue, document custom obsoletion ID warnings with the obsolete API (sometimes groups) that use them in the current ASP.NET Core for .NET 10 branch, and then I am done.

The process will be (as verified with gewarren):

How to find the ASP.NET Core obsolete API for .NET 10 that need to be documented

A. Search for the string "REMOVED" in all "*.unshipped.txt" files in the 10.0 branch.
or
B. Search across the source code for use of ObsoleteAttribute to get a list of everything to document and either compare that to what has been documented so far (which has been up to .NET 9 on the donet docs repo) or cross check against when the attribute was added.

Example:
[Obsolete("IWebHost is obsolete. Use IHost instead. For more information, visit https://aka.ms/aspnet/deprecate/008.", DiagnosticId = "ASPDEPR008", UrlFormat = Obsoletions.AspNetCoreDeprecate008Url)]

After you find obsoletion ID in the .NET 10 branch of the ASP.NET Core source.
  1. Identify what obsolete API share that ID and create one article for one ID that covers all the obsoleted API related.
  2. The contents of what should go in that article can be derived from a breaking changes issue the product team created (if available) which usually includes information such as work arounds or API to use instead of the obsolete API.
    -- Also follow the blame to the PR (or its issue) where the ID was added and find the reasoning there.
  3. The contents should model pretty much the Syslibxxxx examples you showed us as the closest model we can point to as an example of what these articles would look like.
  4. Repeat until every ID in the ASP.NET Core source code for the .NET 10 branch (so I have the latest), has been documented with an API obsolete warning page.
    Only center on for ID's for obsolete API, nothing else for this issue.

Associated WorkItem - 544742

Lingua principale
C#
Stelle
13.1k
Fork
24.5k
Merge medio
3g 6h
PR unite (30g)
210

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di dotnet/AspNetCore.Docs

Tutte le issue di dotnet/AspNetCore.Docs

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.