diff --git a/moduleroot/.gitignore b/moduleroot/.gitignore
index 2da77ae..ed61651 100644
--- a/moduleroot/.gitignore
+++ b/moduleroot/.gitignore
@@ -9,6 +9,10 @@ coverage/
 *.swp
 *.iml
 openstack/
+
+# Files created by releasenotes build
+releasenotes/build
+.tox
 <% if ! @configs['paths'].nil? -%>
 <% @configs['paths'].each do |path| -%>
 <%= path %>
diff --git a/moduleroot/test-requirements.txt b/moduleroot/test-requirements.txt
new file mode 100644
index 0000000..9b046fe
--- /dev/null
+++ b/moduleroot/test-requirements.txt
@@ -0,0 +1,6 @@
+# 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
+# This is required for the releasenotes build jobs
+# FIXME: reno is manually pinned to !=2.0.0 because of bug #1651995
+reno>=1.8.0,!=2.0.0  # Apache-2.0
diff --git a/moduleroot/tox.ini b/moduleroot/tox.ini
new file mode 100644
index 0000000..cd122cb
--- /dev/null
+++ b/moduleroot/tox.ini
@@ -0,0 +1,11 @@
+[tox]
+minversion = 1.6
+skipsdist = True
+envlist = releasenotes
+
+[testenv]
+install_command = pip install -c{env:UPPER_CONSTRAINTS_FILE:https://git.openstack.org/cgit/openstack/requirements/plain/upper-constraints.txt} {opts} {packages}
+
+[testenv:releasenotes]
+deps = -rtest-requirements.txt
+commands = sphinx-build -a -E -W -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html