add markdown parser to documentation building

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

Author: jbweston

docs/source/conf.py

@@ -47,14 +47,18 @@
     '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

@@ -0,0 +1 @@
+../../README.md