It shouldn’t be a pain to maintain OpenAPI files.
The same code you write to validate your request/response should automatically generate the OpenAPI see my comment here:
The same code you write to validate your request/response should automatically generate the OpenAPI see my comment here:
Or even better the opposite: I have a mini-framework [0] which does the validation and routing based on an OpenAPI spec, so the devs can focus on writing the business logic.
Many legacy codebase don't have an easy way to add schema and make code changes so you end up maintaining a separate file to avoid making changes in the codebase.