jhthorsen / mojolicious-plugin-openapi

OpenAPI / Swagger plugin for Mojolicious
54 stars 44 forks source link

As a developer, I would like a tutorial for OpenAPI v3 #112

Closed jhthorsen closed 4 years ago

jhthorsen commented 5 years ago

https://github.com/jhthorsen/mojolicious-plugin-openapi/blob/master/lib/Mojolicious/Plugin/OpenAPI/Guides/Tutorial.pod is currently only for OpenAPI 2. "Someone" should write a guide for v3 as well.

When that is done, then Tutorial.pod should also be renamed.

The new tutorial for v3 should probably have a list of what is missing or not very well tested.

HEM42 commented 4 years ago

I would like to help, quickly looking at it, do you want a separate Tutorial for v3 ?

I was thinking of "translating" the existing examples into v3 and remove the parts with doesn't apply to v3

As for missing/not very well tested list, I dont have any thing just yet for that part.

jhthorsen commented 4 years ago

I'm going to merge #142 at some point, so I'm closing this.

Thanks @HEM42!