replace obsolete m2r with sphinx_mdinclude

[a-detiste]

• PR only contains one change (considered splitting up PR)

[n2ygk]

thanks

rtd build failed

[n2ygk]

RTD build fails with this change. See https://readthedocs.org/projects/django-oauth-toolkit/builds/25221545/

[a-detiste]

It replaces the perfeclty fine docutils by an older one that is too old.

omnilib/sphinx-mdinclude@db37d3f

Downloading docutils-0.18.1-py2.py3-none-any.whl (570 kB)

[a-detiste]

The pinned libs are too old.

sphinx==7.2.6
sphinx-rtd-theme==1.3.0

[n2ygk]

The pinned libs are too old.

sphinx==7.2.6 sphinx-rtd-theme==1.3.0

So please submit an update commit that pins the appropriate versions. the mdinclude version should also be pinned.

[a-detiste]

I have absolutely no idea what an "appropriate version" shoud be. I would simply drop pinning altogether & see what happens.

[n2ygk]

I have absolutely no idea what an "appropriate version" shoud be. I would simply drop pinning altogether & see what happens.

The usual approach is to upgrade everything and make sure it works. Then pin those versions (pip freeze).

[n2ygk]

The point of pinned versions is to avoid future updates that break existing functionality, so a >= test especially for sphinx which has known compatibility issues between major and minor releases. Please:

1. compare what's in docs/requirements.txt with what's in tox.ini. Both are problematic w.r.t. version pinning as it should only be in one place.
2. do a tox -e docs to test the sphinx build to make sure everything works as expected.
3. do a pip freeze and put the appropriate pinned versions into docs/requirements.txt

Thanks.

[dopry]

@a-detiste thanks for your contribution! Do you have time to wrap up this PR? We'd really like to get it in.