update docs structure

- pydata sphinx theme
- enable myst for new docs
- update rtd config
- subdirectories for tutorial, reference
- fix some links
- remove stale, long-skipped winhpc doc

Author: minrk

docs/environment.yml

@@ -0,0 +1,4 @@
+myst-parser
+pydata-sphinx-theme
+sphinx
+sphinx-copybutton

docs/requirements.txt

@@ -49,6 +49,7 @@
     'sphinx.ext.inheritance_diagram',
     'sphinx.ext.intersphinx',
     'sphinx.ext.napoleon',
+    'myst_parser',
     'IPython.sphinxext.ipython_console_highlighting',
 ]
 
@@ -57,8 +58,7 @@
 
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
-# source_suffix = ['.rst', '.md']
-source_suffix = '.rst'
+source_suffix = ['.rst', '.md']
 
 # Add dev disclaimer.
 if iprelease['version_info'][-1] == 'dev':
@@ -144,12 +144,27 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-# html_theme = 'alabaster'
+html_theme = 'pydata_sphinx_theme'
+
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-# html_theme_options = {}
+# https://pydata-sphinx-theme.readthedocs.io/en/latest/user_guide/configuring.html
+html_theme_options = {
+    # "navbar_center": [],  # disable navbar-nav because it's way too big right now
+    "icon_links": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/ipyparallel",
+            "icon": "fab fa-github-square",
+        },
+    ],
+}
+
+html_context = {
+    "github_url": "https://github.com/ipython/ipyparallel",
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []
@@ -262,14 +277,6 @@
         u'The IPython Development Team',
         'manual',
     ),
-    (
-        'parallel/winhpc_index',
-        'winhpc_whitepaper.tex',
-        u'Using IPython on Windows HPC Server 2008',
-        u"Brian E. Granger",
-        'manual',
-        True,
-    ),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of