diff --git a/dev-requirements.txt b/dev-requirements.txt
index 693b8d46d7..05c556807a 100644
--- a/dev-requirements.txt
+++ b/dev-requirements.txt
@@ -4,6 +4,8 @@ hacking>=0.10.0,<0.11
 pep8==1.5.7
 pyflakes==0.8.1
 mccabe==0.2.1 # capped for flake8
+bashate>=0.2 # Apache-2.0
+
+# this is required for the docs build jobs
 sphinx!=1.2.0,!=1.3b1,<1.3,>=1.1.2
 oslosphinx>=2.5.0 # Apache-2.0
-bashate>=0.2 # Apache-2.0
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 44627ea263..f6e3480a34 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -31,6 +31,9 @@ extensions = [
     'oslosphinx'
 ]
 
+# The link to the browsable source code (for the left hand menu)
+oslosphinx_cgit_link = 'http://git.openstack.org/cgit/openstack/openstack-ansible'
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
diff --git a/scripts/gate-check-lint.sh b/scripts/gate-check-lint.sh
index 457b502fd9..a1408d8805 100755
--- a/scripts/gate-check-lint.sh
+++ b/scripts/gate-check-lint.sh
@@ -41,7 +41,7 @@ fi
 # NOTE:
 #     Template files are skipped because they are python executables potentially with Jinja2
 #     expressions and the jinja2 causes a flake8 failures.
-flake8 --ignore=F403,H303 $(grep -rln -e '^#!/usr/bin/env python' -e '^#!/bin/python' -e '^#!/usr/bin/python' * | grep -v 'templates/')
+flake8 --ignore=F403,H303 $(grep -rln -e '^#!/usr/bin/env python' -e '^#!/bin/python' -e '^#!/usr/bin/python' * | grep -v 'templates/\|^doc/')
 
 # Create keys if they don't already exist.
 ssh_key_create
diff --git a/tox.ini b/tox.ini
index 2f2b138e51..f5aa9d26f2 100644
--- a/tox.ini
+++ b/tox.ini
@@ -28,6 +28,7 @@ commands =
         -e '!/bin/python' \
         -e '!/usr/bin/python' \
         --exclude-dir '.*' \
+        --exclude-dir 'doc' \
         --exclude-dir '*.egg' \
         --exclude-dir '*.egg-info' \
         --exclude-dir '*templates' \