migrate from springfox-swagger to springdoc-openapi

[TheGreatRefrigerator]

Currenlty swagger 2 is still used as API specs.
OpenAPI specs have been out for some time an are the go to standard nowadays.

It might be possible to integrate the custom keys used to define parameter dependencies in a more openapi spec native way (to be investigated).

Should be tackled together with ors-website's capability to render openapi.

[MichaelsJP]

This would be great. Could also give us additional abilities in the direction of auto-generated API clients: https://github.com/OpenAPITools/openapi-generator.

[TheGreatRefrigerator]

• parameter dependencies, possible native now?
• extra/custom parameter attributes x-valid-when etc. possible?
• use 3.1 features? summary attribute & new json schema multi type lists

[MichaelsJP]

parameter dependencies, possible native now?

Regarding that one, is this what we're looking for?
https://json-schema.org/understanding-json-schema/reference/conditionals.html

It's also listed here. Just search for dependentSchemas and dependentRequired

[MichaelsJP]

I'ts not visible that springdoc-openapi will integrate these parameters. For the short-term we should use x- to add dependencies. For the medium, longterm, we can think of a class overwrite that adds the functionality, as e.g., the openapi-generator supports at least the dependentRequired tag for the client generation.