dotnet / AspNetCore.Docs

Documentation for ASP.NET Core
https://docs.microsoft.com/aspnet/core
Creative Commons Attribution 4.0 International
12.62k stars 25.31k forks source link

Enhance documentation for Swashbuckle and NSwag #8194

Open rynowak opened 6 years ago

rynowak commented 6 years ago

We recently did some gap analysis between what you get naively from a swagger framework, and what a 'canonical' swagger document looks like. Many of the gaps are features that are already included by 3rd party swagger frameworks like NSwag and Swashbuckle.

We'd like to add additional docs coverage of how to configure all of the items here: https://github.com/aspnet/Mvc/issues/6877

Rick-Anderson commented 5 years ago

@scottaddie should I tie this issue to https://docs.microsoft.com/en-us/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-2.2&tabs=visual-studio and move it there?