Keep APIs documented using OAS (swagger) docs
API would be good to keep documented, and we could use some automated ways of creating the docs following OpenAPI way. It would be useful for the later users of API. This way the docs will be easy to keep in sync, and offers standard way for developers to consume the API. One option would be to utilize Restplus which works with Flask.