asyncapi-archived-repos / docgen

AsyncAPI documentation generator. DEPRECATED in favour of
https://github.com/asyncapi/generator
Apache License 2.0
21 stars 11 forks source link

AllOf is not rendering #21

Closed approxit closed 6 years ago

approxit commented 6 years ago

Merging parts of different objects is fun. OpenAPI understands it but unfortunately cant render it properly in editor and offline documentation.

Simplest example:

asyncapi: 1.0.0
info:
  title: Example API
  version: "1.0"
topics:
  example.topic:
    publish:
      payload:
        allOf:
          - type: object
            properties:
              foo:
                type: string
          - type: object
            properties:
              bar:
                type: string

Results in empty payload table: results

AsyncAPI does not mention about its limitations and OpenAPI plays with XOf nicely.

fmvilas commented 6 years ago

Yes, it's a known limitation. I should probably add it to the documentation meanwhile it's not supported. PRs are welcome too 😊

fmvilas commented 6 years ago

@approxit a solution has been released and pushed to npm under version 1.8.0.

approxit commented 6 years ago

Marvelous! Thanks for that.