https://www.reddit.com/r/dotnet/comments/a2181x/swashbuckle_vs_nswag/

Swashbuckle

https://github.com/aspnet/Docs/issues/4258

在官方的文档中引入NSwag的时机

https://github.com/domaindrivendev/Swashbuckle  这个项目不维护了

With the introduction of ASP.NET Core, I've now shifted my focus to the Core-specific project - Swashbuckle.AspNetCore.

That will be receiving most of my (already limited) personal time, and so I won't have the capacity to maintain this one at a sufficient rate.

https://github.com/domaindrivendev/Swashbuckle.AspNetCore

应该还是这个好用一点   但是这个不支持传统的asp.net web api，上面的Swashbuckle是支持的(因为不维护了，所以还是考虑用NSwag)。

NSwag

https://github.com/RSuter/NSwag

Tutorials:

• Video Tutorial: How to integrate NSwag into your ASP.NET Core Web API project (5 mins)
• Integrate the NSwag toolchain into your ASP.NET Web API project     直接用在传统的asp.net web api项目上
• Generate an Angular TypeScript client from an existing ASP.NET Web API web assembly

https://blog.rsuter.com/nswag-tutorial-integrate-the-nswag-toolchain-into-your-asp-net-web-api-project/