Use drf-yasg for demo project

[hashlash]

Previously on the demo project, /docs raise an error caused by django-rest-swagger (related issue). And since the project is no longer maintained, we can use drf-yasg as its alternative (as mentioned on the repo).

[auvipy]

why not using https://www.django-rest-framework.org/api-guide/schemas/ instead?

[hashlash]

@auvipy, I haven't actually explored any other alternatives yet. I just saw that drf-yasg is mentioned on the deprecated django-rest-swagger's repo, and it just works :)

[tfranzel]

A little late to the party but i just stumbled over this and wanted to let you guys know there is another alternative: drf-spectacular https://github.com/tfranzel/drf-spectacular/ (disclaimer: author speaking 😄 )

Since some views here are not introspectable (e.g. no serializer_class attr), we added explicit declarations for the missing pieces. Due to this explicit support i'm quite confident the schema would look a lot better than drf-yasg or DRF native.

This is the test schema for our dj_rest_auth contrib support. You can judge it yourself: https://github.com/tfranzel/drf-spectacular/blob/master/tests/contrib/test_rest_auth.yml

have a nice day!