The current situation of OpenAPI 3 vs 3 support:
- TES spec is exclusively in OpenAPI 3
- The current version of TESK uses a new version of OpenAPI Generator for Spring in the form of Maven Plugin
- The generator and plugin accept specification in OpenAPI 3, but the generated annotations correspond to Swagger 2.
- It does not seem at the moment to be possible to generate OpenAPI 3 models or at least it is not straightforward:
- Issue 8703
- Issue 5803
- PR 6306
and more.
Additionally, there seems to be now an alternative to SpringFox in the form of SpringDoc
Verdict: for now TESK will present OpenAPI 2 docs via UI and wait for support of OpenAPI3 in generator or an alternative solution.