OpenAPI docs are not clear. The new OpenAPI feature is only meant to work with Minimal API and not Controller API

[vitasystems]

Description

According to this conversation dotnet/aspnetcore#59980

This feature is only developed for Minimal API so the documentation should clarify that.

Even though in the conversation it talks about a work around for the Json Configuration issues, nevertheless other issues could exist now or in the future due to the fact that this feature is developed based on Mnimal API only.

Also the article should clarify what should any one using Controller API do for OpenAPI as an alternative, specially because microsoft removal of Swashbuckle from the templates has caused confusion and this article makes you think that Microsoft.AspNetCore.OpenApi is now the official way to go.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/openapi/aspnetcore-openapi?view=aspnetcore-9.0&tabs=visual-studio

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/openapi/aspnetcore-openapi.md

Document ID

27bad30c-e0b4-10fb-b202-a29d4f8fad24

Article author

@captainsafia

Metadata

• ID: 27bad30c-e0b4-10fb-b202-a29d4f8fad24
• Service: aspnet-core
• Sub-service: fundamentals

Related Issues