docs refresh, support markdown && move to furo (#2131)

Author: ewdurbin

docs-requirements.txt

@@ -1,2 +1,3 @@
-Sphinx
-sphinx_rtd_theme
+sphinx
+myst-parser
+furo

docs/source/conf.py

@@ -8,6 +8,7 @@
     'sphinx.ext.autodoc',
     'sphinx.ext.todo',
     'sphinx.ext.viewcode',
+    'myst_parser',
 ]
 
 templates_path = ['_templates']
@@ -22,18 +23,19 @@
 # The full version, including alpha/beta/rc tags.
 release = '1.0'
 
+html_title = 'Python.org Website'
+
 pygments_style = 'sphinx'
 
-try:
-    import sphinx_rtd_theme
-except ImportError:
-    html_theme = 'default'
-else:
-    html_theme = 'sphinx_rtd_theme'
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+html_theme = "furo"
 
 htmlhelp_basename = 'PythonorgWebsitedoc'
 
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
+
 
 # -- Options for LaTeX output ---------------------------------------------