jnv/wug-days-2023

Resources for my talk at WUG Days Brno 2023

Materials for “How to create an (acceptable) OpenAPI Specification” talk

Contents

• Meows/ is an ASP.NET API used for code samples
• specs/ contains snapshots of OAS documents in various stages

Resources

• Swashbuckle
• OpenAPI.NET
• NSwag

Tooling

• openapi.tools
• Reference docs
  • Swagger UI
  • Redoc
  • Stoplight Elements
  • Docusaurus: docusaurus-plugin-openapi-docs, Docusaurus OpenAPI
• SDK generation
  • NSwagStudio
  • OpenAPI Generator
• Testing
  • Dredd
  • Schemathesis
  • Hot Potato
  • Stoplight Prism
• Changes validation
  • openapi-diff
  • openapi-comparator
• AI
  • ChatGPT plugins
  • Superface