Since your comment we’ve been looking into what it would take to auto-generate the swagger docs. The package we’re thinking about using produces OpenAPI v2 json but I understand there is now OpenAPI v3 that people have been using for a while. Do you have a need for v3 or would v2 be ok?
I don’t have a need for v3, but I’d caution that you might do - v2 is missing quite a few features compared to v3. For example, Swagger v2 doesn’t support oneOf, allOf and anyOf. I believe you’re using some of those in the docs currently? I’d check but I’m not near a computer right now. I’m happy using v2 if you’re happy with it.
Edit: oops, typed some of the versions numbers the wrong way around. Apologies for any confusion
Since your comment we’ve been looking into what it would take to auto-generate the swagger docs. The package we’re thinking about using produces OpenAPI v2 json but I understand there is now OpenAPI v3 that people have been using for a while. Do you have a need for v3 or would v2 be ok?
Thanks for looking into it :)
I don’t have a need for v3, but I’d caution that you might do - v2 is missing quite a few features compared to v3. For example, Swagger v2 doesn’t support
oneOf,allOfandanyOf. I believe you’re using some of those in the docs currently? I’d check but I’m not near a computer right now. I’m happy using v2 if you’re happy with it.Edit: oops, typed some of the versions numbers the wrong way around. Apologies for any confusion