Merge pull request #492 from willingc/docs-testtool

Update for additional build information from Read The Docs

docs/requirements.txt

@@ -1,3 +1,5 @@
+jupyter
+sphinx_rtd_theme
 jinja2
 tornado
 -e git+https://github.com/ipython/ipython_genutils.git#egg=ipython_genutils

docs/source/conf.py

@@ -20,12 +20,30 @@ import shlex
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.insert(0, os.path.abspath('.'))
-sys.path.insert(0, os.path.abspath('../..'))
+
+# DEBUG for RTD
+print("DEBUG:: sys.path")
+print("================")
+for item in sys.path:
+    print(item)
+
+print("os.path.abspath('..')")
+print("=====================")
+print(os.path.abspath('..'))
+
+# Insert absolute path into system path
+sys.path.insert(0, os.path.abspath('..'))
+
+# DEBUG for post insert on RTD
+print("DEBUG:: Post insert to sys.path")
+print("===============================")
+for item in sys.path:
+    print(item)
 
 # Check if docs are being built by ReadTheDocs
 # If so, generate a config.rst file and populate it with documentation about
 # configuration options
+
 if os.environ.get('READTHEDOCS', ''):
 
     # Readthedocs doesn't run our Makefile, so we do this to force it to generate