> Having said that (and derailing a bit), I would want v3 not only to > comply with json:api but also to be documented with http://swagger.io/ > instead. This gives us: > > - automated, better docs than what we have (example > http://petstore.swagger.io/#!/pet/updatePet) > - automated tests to ensure docs do what they say > - generates an SDK for the API in many languages > automatically through https://github.com/swagger-api/swagger-codegen >
If you are going to move away from REST that far, why stick with it at all and not switch to something like grpc? -d -- You received this message because you are subscribed to the Google Groups "foreman-dev" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
