How to configure OpenAPI, Swashbuckle, OAuth2, and XML comments in .NET 8 before migrating to .NET 9.
In Part 1 I'm showing the "old" way of doing things using .NET 8 and Swashbuckle. I hightlight why this is not outdated in terms of OpenAPI and what I do in order to improve maintainablility and dev-experience. You learn how to effectively configure OAuth flows and XML comments and how API versions are introduced.
Source Code: github.com/codingfreak/blogsamples/tree/master/ApiConversion
I know that it got pretty long again but I want to show the stuff as deep as possible so that everybody can really appreciate the changes in .NET 9. So stay tuned.
[] Introduction
[] Presentation
[] Demo of default project template
[] Rabbit Hole #1 - no blank line plz
[] Rabbit Hole #2 - Why Swagger only in dev?
[] Explaning template code
[] Rabbit Hole #3 - What I don't like about MS default template.
[] My sample solution - demo
[] Details of my solution - Pro`s should skip this (not really)
[] Outro
Why it's here
1 person recommends this
What people say. Recommended as a detailed guide on configuring OpenAPI and Swashbuckle in .NET 8 before migrating to .NET 9.
W
u/WingedHussar98in r/dotnet • Recommends
Moving to .NET 9 and OpenAPI
Over the last month there have been quite a few questions and discussions regarding OpenAPI and .NET 9 so I wanted to share the following 2 parted Video as a hopefully helpful ressource.
Part 1: Focussing on the "classic" way with swashbuckle and .NET 8
link to this video
Part 2: Focussing on moving to .NET 9 and OpenAPI
link to this video