Investigate auto-generation of Swagger docs
What is the problem you are facing?
Currently we maintain our Swagger documentation by hand. This means that any changes to the API require a manual documentation update no matter how minor, and also leads to missing documentation if this is forgotten. There are options to automatically generate Swagger documentation from Django Rest Framework that would ease the administrative burden of maintaining these docs, and ensure that we don't miss new changes.
What are the possible drawbacks or issues with the requested changes?
May require additional context to be added to the APIs themselves, so would require upfront time investment to sort out.