https://www.reddit.com/r/dotnet/comments/a2181x/swashbuckle_vs_nswag/
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