4 ms·
Agreed. The extra stuff you get "for free" from the OpenAPI ecosystem is well worth the extra time it takes to write the spec. If you don't want things like cl
by resonious 1y ago
Agreed. The extra stuff you get "for free" from the OpenAPI ecosystem is well worth the extra time it takes to write the spec.
If you don't want things like client/server generators and documentation, then sure it's not great
- cyberax 1y agoYou still need to write a spec with protobufs. It's just that the spec is much more succinct and easy to read. And you can generate docs from it. E.g.: https://cloud.google.com/appengine/docs/admin-api/reference/rpc/google.cloud.location#listlocationsrequest https://cloud.google.com/appengine/docs/admin-api/reference/... Do an experiment, take a Protobuf spec for some Google API and convert it into OpenAPI.
- deployhq 1y agoWe have used the gem: https://github.com/a-chacon/oas_rails https://github.com/a-chacon/oas_rails, and we didn't need to write the specs, just comment the endpoints