I often write swagger files that are fed to a library[0] that maps them to Flask endpoints and does input validation. Writing the schema is always a painful ex

I often write swagger files that are fed to a library[0] that maps them to Flask endpoints and does input validation. Writing the schema is always a painful experience. I find the result overly verbose and not human friendly. Which makes me think that these things shouldn't be hand crafted. > I believe this can be very interesting since it allows you to centralize documentation, generate protocol-agnostic clients to share with other teams in your organisation, etc. On the paper yes, but I have yet to come across formal API specification used this way. The only usage I see in the wild is the generation of web API browsers, a la swagger UI. [0] https://github.com/zalando/connexion https://github.com/zalando/connexion