Allow description for the oneOf selectors

Open monolithed opened this issue 7 years ago • 5 comments

paths:
  /method:
    post:
      description: My DEFAULT description
        requestBody:
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/RequestOne'
                  - $ref: '#/components/schemas/RequestTwo'

components:
  schemas:
    RequestOne:
      description: My OPTIONAL description for the first method

    RequestSecond:
      description: My OPTIONAL description for the second method

It would be nice to change the description section at the top level of the method as well.