SmartCambridge / tfc_web

Web access to the TFC platform
MIT License
3 stars 2 forks source link

Rewrite API schema and Docs to use OpenAPI before DRF v3.12 #346

Open jw35 opened 4 years ago

jw35 commented 4 years ago

Django REST Framework is deprecating CoreAPI based schema generation in favour of OpenAPI schema. In theory that's a good idea, if it wasn't for the investment we have in CoreAPI documentation.

v3.10 requires/required explicit workarounds to allow CoreAPI to continue to work. Removal for CoreAPI is scheduled for v3.12 - we'll need to have transitioned by then.