Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

ASP.NET Core Web Api automatic help pages

In previous versions of ASP.NET, when I created Web Api 2, visual studio automatically wired up automatic generation of documentation for the API.

It's also explained here: http://www.asp.net/web-api/overview/getting-started-with-aspnet-web-api/creating-api-help-pages

I'm writing a new project and I've decided to do it with ASP.NET Core, but I don't see anything similar to what existed in the previous versions that generates the documentation from the API (I'm also guessing that's its a bit different since all controllers now inherit from the same Controller class).

But, is there some way to have help files generated for ASP.NET Core APIs?

like image 659
developer82 Avatar asked Aug 02 '16 15:08

developer82


1 Answers

The functionality you want is at https://github.com/domaindrivendev/Swashbuckle

The following link provides an example of how to configure and use the well-designed utility https://damienbod.com/2015/12/13/asp-net-5-mvc-6-api-documentation-using-swagger/

like image 95
John Davidson Avatar answered Sep 23 '22 07:09

John Davidson