While investigating an issue related to types and inheritance, seems like working on a ModelConverter is the answer.
But when trying to work on that, I've found extremely hard because AnnotatedType has no javadoc at all.
Some solutions found here, for instance, suggest marking resolveAsRef as false.
Others do check validations on type depending on the parent value.
Even though most of that is quite "guessable" after playing with swagger for a while, having javadoc is crucial in my opinion.
While investigating an issue related to types and inheritance, seems like working on a
ModelConverteris the answer. But when trying to work on that, I've found extremely hard becauseAnnotatedTypehas no javadoc at all.Some solutions found here, for instance, suggest marking
resolveAsRefas false. Others do check validations ontypedepending on theparentvalue. Even though most of that is quite "guessable" after playing with swagger for a while, having javadoc is crucial in my opinion.