add markdown parser to documentation building

Also replace index.rst with a verbatim copy of the readme (for now).

docs/source/conf.py

@@ -47,14 +47,18 @@ extensions = [
     'sphinx.ext.napoleon',
 ]
 
+source_parsers = {
+   '.md': 'recommonmark.parser.CommonMarkParser',
+}
+
 # Add any paths that contain templates here, relative to this directory.
 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_suffix = ['.rst', '.md']
+#source_suffix = '.rst'
 
 # The master toctree document.
 master_doc = 'index'

docs/source/index.md

+../../README.md
\ No newline at end of file

docs/source/index.rst

-.. adaptive documentation master file, created by
-   sphinx-quickstart on Mon Aug 20 16:51:02 2018.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-Welcome to adaptive's documentation!
-====================================
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
-
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`