News for hackers. Stuff that matters.
Re:OpenAPI 3.0.3 Specification Released by yxhuvud on Friday February 21, 2020 @03:45AM (#22381777)
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.

Re:OpenAPI 3.0.3 Specification Released by hardwaresofton on Friday February 21, 2020 @07:36PM (#22388498)