Use MyST for markdown docs build

Moves away from recommonmark to MyST when building the markdown docs.
Recommonmark is deprecated and no longer maintained in favour of MyST.
The only change here is to swap up the dependencies and enable the MyST
plugin in the conf.py.

Signed-off-by: Jordan Borean <jborean93@gmail.com>

docs-requirements.txt

@@ -1,4 +1,4 @@
+myst-parser  # For parsing markdown docs instead of rst
 Sphinx >= 1.3.1
 sphinx-autoapi
 sphinx-rtd-theme >= 0.2.5b1
-recommonmark >= 0.4.0

docs/source/conf.py

@@ -20,8 +20,6 @@
 
 sys.path.insert(0, os.path.abspath('../custom_extensions'))
 
-from custom_recommonmark import AllCodeCommonMarkParser
-
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -30,6 +28,7 @@
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = [
+  'myst_parser',
   'sphinx.ext.autodoc',
   'sphinx.ext.intersphinx',
   'sphinx.ext.viewcode',
@@ -47,14 +46,11 @@
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
-# Parsers for different suffixes
-source_parsers = {
-    '.md': AllCodeCommonMarkParser
-}
-
 # The suffix of source filenames.
 source_suffix = ['.rst', '.md']
 
+myst_all_links_external = True
+
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'