From d6ca45dc6628c53f17c82498f3f215bb33506a3f Mon Sep 17 00:00:00 2001
From: Kurt Griffiths <kurt.griffiths@rackspace.com>
Date: Tue, 18 Oct 2016 17:24:56 -0600
Subject: [PATCH] doc: Show banner for prereleases

---
 docs/_static/custom.css          | 7 +++++++
 docs/_templates/sidebar-top.html | 8 ++++++++
 docs/conf.py                     | 4 ++++
 3 files changed, 19 insertions(+)

diff --git a/docs/_static/custom.css b/docs/_static/custom.css
index a7a951c..682d71a 100644
--- a/docs/_static/custom.css
+++ b/docs/_static/custom.css
@@ -30,6 +30,13 @@
     /*margin: -4px -4px 0 0;*/
 }
 
+#dev-warning {
+    background: #ffe;
+    border: 1px solid #aaa;
+    padding: 10px;
+    margin-bottom: 1em;
+}
+
 div.body h1,
 div.body h2,
 div.body h3,
diff --git a/docs/_templates/sidebar-top.html b/docs/_templates/sidebar-top.html
index db5c1e1..1ecfa51 100644
--- a/docs/_templates/sidebar-top.html
+++ b/docs/_templates/sidebar-top.html
@@ -1,6 +1,14 @@
 <link href='http://fonts.googleapis.com/css?family=Amethysta:400' rel='stylesheet'>
 <script async defer src="https://buttons.github.io/buttons.js"></script>
 
+{% if prerelease %}
+<script>
+$(document).ready(function() {
+    $('div.body').prepend('<div id="dev-warning">Warning: This is the documentation for the development version of Falcon.</div>')
+});
+</script>
+{% endif %}
+
 <div id="logo">
     <div id="logo-text"><a href="{{ pathto(master_doc) }}">Falcon</a></div>
     <a href="{{ pathto(master_doc) }}"><img src="{{ pathto('_static/img/logo.png', 1) }}" width="163" height="211" alt="Falcon Web Framework Logo"/></a>
diff --git a/docs/conf.py b/docs/conf.py
index f1f98d0..ad11a5e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -77,6 +77,10 @@ cfg = configparser.SafeConfigParser()
 cfg.read('../setup.cfg')
 tag = cfg.get('egg_info', 'tag_build')
 
+html_context = {
+  'prerelease': bool(tag),  # True if tag is not the empty string
+}
+
 # The short X.Y version.
 version = '.'.join(falcon.__version__.split('.')[0:2]) + tag