I’ve been slowly working on a pull request that puts some working API docs tooling into place in edx-platform: https://github.com/edx/edx-platform/pull/21207
I’d love to hear comments about it. It uses drf-yasg and its swagger_auto_schema decorator, with Markdown for descriptions. It publishes both dynamic swagger docs, and static Sphinx-generated docs.
Comments about details of the pull request can go on the pull request. Larger discussion can be here.