Provide generated openapi specs
This is an ongoing effort to provide automatically generated, up-to-date and valid specification of our API.
Currently we already went most of the way, its still a lot to do.
The advantage is that developers of tools using our API have more accurate, up to date information and implementation of clients should be easier. Additionally we can generate client libraries which can be used by a variety of tools.
The library we are using is drf-spectacular, which does a great job. The latest version for the develop branch can be found here.