kogosoftwarellc / open-api

A Monorepo of various packages to power OpenAPI in node
MIT License
895 stars 237 forks source link

Migrate code from openapi v2 to v3 #726

Open vguillot opened 3 years ago

vguillot commented 3 years ago

Hi guys With the official release of openapi 3.0.0, I tried to convert my swagger 2 to it. I have to admit that it is very heavy. The fact that I have hundreds of route is obviously not helping. I could make some json adaptation about "definitions" "schema" and others naming stuff, but structurally, the fact that the object apiDoc is not used to build openapi 3.0.0 makes me think that I cannot doing it without a full rewrite. Did I think wrong about it? Or did I miss a method or an option to doing it without too much heavy stuff?

jsdevel commented 3 years ago

@vguillot hard to say without looking at your project. i'd suggest limiting your upgrade to a few routes at a time.