> Is there a benefit to describing APIs using YAML "describing HTTP APIs using YAML" (or JSON) is OpenApi/Swagger. AsyncAPI appears to be the "OpenApi, but f

> Is there a benefit to describing APIs using YAML "describing HTTP APIs using YAML" (or JSON) is OpenApi/Swagger. AsyncAPI appears to be the "OpenApi, but for message queues" (and similar async communication mechanisms). > Basically all you can do is generate HTML docs from YAML. With OpenApi, you can generate interactive docs, where you can build and execute requests against a real API (not in prod, we hope) You can generate code off OpenApi (and not just python and Java*). Anything from just DTOs to full clients. You can generate stub servers. You can inspect server code and flag up where it differs from the spec. You can test your API.