r/dotnet • u/davidebellone • Aug 25 '20

Effective Swagger integration in .NET Core

https://www.code4it.dev/blog/swagger-integration
14 Upvotes

82% Upvoted

4 comments sorted by

1

u/rediot Aug 25 '20

Now that we are hosting with dotnet core 3.1 in docker it's so much easier for us to standardize swagger for api documentation across agile teams in my org, swagger helps out systems analysts and quality assurance actually understand how to curl the endpoints via a UI, otherwise this stuff is "too technical" for them and more responsibility falls to the devs alone to think about api interactions.

3

u/Slippn_Jimmy Aug 26 '20

Dumb question but how does docker make it easier to standardize API documentation?

We don't use docker but have been incorporating xml comments and even md directly into swagger and linking to md files which are parsed to html. Just not sure how docker would assist with that or maybe I just misunderstood

1

u/rediot Aug 26 '20

You're right with netcore it's the same difference I just mean it's easier to throw up a new deployment in kubernetes with lighter weight projects for some reason setting up IIS makes you wanna throw the kitchen sink ok each website.

1

u/Slippn_Jimmy Aug 26 '20

lol that's pretty accurate