I prefer reading proto files with services over OpenAPI yaml. Here's the pet store example to compare.

- https://github.com/project-flogo/grpc/blob/master/proto/grpc...

- https://github.com/OAI/OpenAPI-Specification/blob/main/examp...