Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Possibility of adding additional examples for how to express polymorphism #403

@Mattias-Sehlstedt

Description

@Mattias-Sehlstedt

TL:DR: I am interested in contributing to the polymorphism section with additional descriptions and examples, so I am wondering if someone semi-actively monitors the issues in this repo?

I have been working a lot recently with ways of expressing and interpreting polymorphism in openapi-specifications. This in the context of projects such as Springdoc (interpret code to generate a specification) and Openapi-generator (specification to code).

I have encountered many different ideas of how to do this best/correct. and I love when it is possible to use a centralized reputable source. So far I have been using this documentation a lot, but I have seen some scenarios that I am unsure about. I would like to discuss them with you, and see if it is something that could be added to the doc.

So I am initially trying to see if the issues in this repo are monitored, and to what extent that one can find someone to comment on my suggestions and potentially merge them if they are of value.

The subject that I am interested in expanding upon is that polymorphism has to main implementations, either the standard oneOf that already exists in the documentation, but it can also be achieved with allOf similarly to how it is presented in the allOf section.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions