upgrade to m2r2 and sphinx patch

Author: tomvanmele

docs/conf.py

@@ -9,12 +9,29 @@
 import os
 import inspect
 import importlib
+import m2r2
 
 import sphinx_compas_theme
 from sphinx.ext.napoleon.docstring import NumpyDocstring
 
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), '../src'))
 
+# patches
+
+current_m2r2_setup = m2r2.setup
+
+def patched_m2r2_setup(app):
+    try:
+        return current_m2r2_setup(app)
+    except (AttributeError):
+        app.add_source_suffix(".md", "markdown")
+        app.add_source_parser(m2r2.M2RParser)
+    return dict(
+        version=m2r2.__version__, parallel_read_safe=True, parallel_write_safe=True,
+    )
+
+m2r2.setup = patched_m2r2_setup
+
 # -- General configuration ------------------------------------------------
 
 project = "COMPAS"

requirements-dev.txt

@@ -9,7 +9,7 @@ invoke >=0.14
 ipykernel
 ipython >=5.8
 isort
-m2r
+m2r2
 nbsphinx
 pydocstyle
 pytest >=3.2