@odrotbohm My advice for years has been that if you feel like you need GraphQL, your API is designed poorly and you should fix the API. #ContractFirst, #OpenAPI, and #APIContracts should have been used for the UI/UX people to communicate with the backend team what they need, when, and how much.

@fxnn Let me rephrase what I wanted to say: a) it’s not a proposal, but a description what we do
b) using #contractfirst we don’t rely on a generated OpenAPI, but a complete edited one (using apicur.io as tool, nobody wants to manually maintain huge YAML files). It comes with prose for human consumption and examples exercisable in Postman and Swagger. Imho close enough

@mfowler For http based APIs we use tools like Postman including tests to demo. New APIs we base on OpenAPI which lends itself to a Swagger UI and if properly fleshed out ( shoutout to https://apicurio.io ) documentation too #OpenAPI #swagger #contractfirst