Obsolete Mvc.Api.Analyzers shipped in the framework

[captainsafia]

The Mvc.Api.Analyzers package that is currently shipped as part of the ASP.NET Core framework should be obsoleted. This analyzer package was designed to provide compile-time analysis for Web API controllers, but its utility and maintenance burden may no longer justify its inclusion in the core framework.

The Mvc.Api.Analyzers package provides static analysis rules for ASP.NET Core Web API controllers, including:

• Detecting missing or incorrect HTTP status code documentation
• Validating API controller conventions
• Ensuring proper use of action result types

Over the past few years, they've not received active maintenance to evolve with new language and framework features. Usage is low since the analyzers require explicit opt-in an MSBuild flag.

[danmoseley]

These have marker types - ApiConvention** which I think we're assuming won't go away, in case someone/thing else uses them. But perhaps should be marked Obsolete.

[captainsafia]

These have marker types - ApiConvention** which I think we're assuming won't go away, in case someone/thing else uses them. But perhaps should be marked Obsolete.

The ApiConvention types are used extensively in ApiExplorer and other areas of MVC so they are a little too engrained to deprecate.

[danmoseley]

aspnet/Announcements#521