sphinx: use MyST for markdown rendering

this allows to have full support for all sphinx directives and link types

replaces previous use of plain CommonMark parsing

requirements.txt

@@ -6,6 +6,6 @@ sphinxcontrib-httpdomain
 sphinxcontrib-images
 sphinxcontrib-programoutput
 sphinx-tabs
-recommonmark
 sphinx_rtd_theme
 sphinx-click
+myst-parser

swh/docs/sphinx/conf.py

@@ -29,6 +29,7 @@ extensions = [
     "sphinx_rtd_theme",
     "sphinx.ext.graphviz",
     "sphinx_click.ext",
+    "myst_parser",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -37,12 +38,7 @@ templates_path = ["_templates"]
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
-source_suffix = [".rst", ".md"]
-# source_suffix = '.rst'
-
-source_parsers = {
-    ".md": "recommonmark.parser.CommonMarkParser",
-}
+source_suffix = ".rst"
 
 # The master toctree document.
 master_doc = "index"