Explore the unconventional approach to implementing OpenAPI in .NET development in this conference talk from NDC Oslo 2023. Discover why manually writing and maintaining OpenAPI files as YAML might be the superior method over using Swashbuckle or NSwag. Learn about the benefits of including OpenAPI files in version control, generating Markdown documentation through GitHub actions, and providing easy access to API specifications without running the application. Gain insights into new NuGet packages that offer enhanced functionality for static OpenAPI files, including SwaggerUI serving, documentation generation with code samples, application and test stub creation, and implementation validation against specifications. Challenge your current OpenAPI practices and consider adopting a more efficient and maintainable approach to API documentation in .NET projects.
Overview
Syllabus
OpenAPI & .NET: You're Doing It Wrong - Mark Rendle - NDC Oslo 2023
Taught by
NDC Conferences