Visual Studio Toolbox Live: Versioning and Documenting Web APIs

Phil Japikse demonstrates how to add versioning and documentation to ASP.NET Core RESTful services.
Featuring: Leslie Richardson (@lyrichardson01), Phil Japikse (@skimedic)
#VisualStudio #documentation #aspnet

[@fgb0100]

Welcome!

[@govindkarthikeyan]

When we host API in IIS how can I make the swagger UI as default index page ?

[@marklnz]

It *is* currently possible to version minimal APIs right now, but I agree that when you're building a full-fledged API, that serves as a critical part of your infrastructure, or even serves as a product in it's own right, you really want to have full control over the whole pipeline, including versioning. So you don't want to be doing minimal in that case.
HOWEVER, it's funny that Phil dismisses minimal API as "fine for testing but not for production" (paraphrasing) yet he proposes using swagger to document APIs....swagger is an amateurish approach, IMHO. You really want to have something better if you're making a serious API. I mean, just look at all the declarative nonsense you need to pollute your code with at 55:15 for example! FFS