conf tidyup

conf.py

@@ -1,31 +1,11 @@
 # -*- coding: utf-8 -*-
 #
-# JADE documentation build configuration file, created by
-# sphinx-quickstart on Fri Aug 11 14:47:25 2017.
-#
-# This file is execfile()d with the current directory set to its
-# containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-# 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.
-#
 import os
 import sys
 # sys.path.insert(0, os.path.abspath('.'))
 
 # -- General configuration ------------------------------------------------
 
-# If your documentation needs a minimal Sphinx version, state it here.
-#
-# needs_sphinx = '1.0'
-
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
@@ -88,7 +68,7 @@ def setup(app):
         #app.add_javascript("custom.js")                                         
         app.add_stylesheet('customtheme.css')                                
 else:                                                                            
-    # Override default css to get a larger width for ReadTheDoc build            
+    # OIf building on RTD then we need to manually override the css to include the theme customisation          
     html_context = {                                                             
         'css_files': [                                                           
             'https://media.readthedocs.org/css/sphinx_rtd_theme.css',            
@@ -101,18 +81,6 @@ def setup(app):
 # Path should be relative to the ``_static`` files directory.
 html_logo = 'images/jade_logo_small.png'
 
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-# html_static_path = ['_static']
-
-# Custom sidebar templates, must be a dictionary that maps document names
-# to template names.
-#
-# This is required for the alabaster theme
-# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
-
 # -- Options for HTMLHelp output ------------------------------------------
 
 # Output file base name for HTML help builder.