Fix spacing between parameter and parameter type in the API docs (#301)

This is a work-around for a sphinx/numpydoc/sphinx_rtd_theme bug.

Also fix flake8 issue in conf.py.

Author: lesteve

docs/source/conf.py

@@ -6,6 +6,8 @@
 # full list see the documentation:
 # http://www.sphinx-doc.org/en/stable/config
 
+from dask_jobqueue import __version__ as version
+
 # -- Path setup --------------------------------------------------------------
 
 # If extensions (or modules to document with autodoc) are in another directory,
@@ -24,8 +26,6 @@
 copyright = u"2018, Anaconda, Inc. and contributors"
 
 
-from dask_jobqueue import __version__ as version
-
 # The full version, including alpha/beta/rc tags.
 # release = '0.1.0'
 release = version
@@ -198,3 +198,13 @@
     "issue": ("https://github.com/dask/dask-jobqueue/issues/%s", "GH#"),
     "pr": ("https://github.com/dask/dask-jobqueue/pull/%s", "GH#"),
 }
+
+
+# Temporary work-around for spacing problem between parameter and parameter
+# type in the doc, see https://github.com/numpy/numpydoc/issues/215. The bug
+# has been fixed in sphinx (https://github.com/sphinx-doc/sphinx/pull/5976) but
+# through a change in sphinx basic.css except rtd_theme does not use basic.css.
+# In an ideal world, this would get fixed in this PR:
+# https://github.com/readthedocs/sphinx_rtd_theme/pull/747/files
+def setup(app):
+    app.add_stylesheet("basic.css")