3 ms·
The part about generating clients and servers is the part that has always been the least interesting to me, and the part that I wish hadn't been a goal, because
by yxhuvud 7y ago
The part about generating clients and servers is the part that has always been the least interesting to me, and the part that I wish hadn't been a goal, because it means bending over backwards to not break the generators. This has really hurt the descriptive power of OpenAPI.
If a viable API documentation tool based on raw unmodified jsonschema with some additions to be able to describe the HTTP actions and parameters, and with the ability to visualize it as documentation, came around then I'd switch in a heartbeat.
- hardwaresofton 7y agoToday is your lucky day! Have you heard of jsonschema[0]'s hyperschema[1][2]? [0]: https://json-schema.org https://json-schema.org [1]: https://datatracker.ietf.org/doc/draft-handrews-json-schema-hyperschema https://datatracker.ietf.org/doc/draft-handrews-json-schema-... [2]: https://json-schema.org/implementations.html#hyper-schema https://json-schema.org/implementations.html#hyper-schema