Provide doc build requirements

Change-Id: Idab6f10f92f7f2e40962f1cabaac8691e6c46619

.docs-requirements.txt

@@ -0,0 +1,31 @@
+# As ``readthedocs`` will not use tox, we have to explicitly provide the doc
+# build requirements that are not included in requirements.txt.
+#
+# Unfortunately, we'll have to update this file manually at least once per
+# release.
+
+# The order of packages is significant, because pip processes them in the order
+# of appearance. Changing the order has an impact on the overall integration
+# process, which may cause wedges in the gate later.
+
+# We'll have to make sure that the nova branch matches the compute-hyperv one.
+-e git+http://github.com/openstack/nova.git#egg=nova
+
+hacking<0.13,>=0.12.0 # Apache-2.0
+
+coverage!=4.4,>=4.0 # Apache-2.0
+ddt>=1.0.1 # MIT
+python-subunit>=1.0.0 # Apache-2.0/BSD
+sphinx!=1.6.6,>=1.6.2 # BSD
+oslo.config>=5.1.0 # Apache-2.0
+oslosphinx>=4.7.0  # Apache-2.0
+oslotest>=3.2.0 # Apache-2.0
+testrepository>=0.0.18 # Apache-2.0/BSD
+testtools>=2.2.0 # MIT
+openstackdocstheme>=1.18.1 # Apache-2.0
+
+# placement functional tests
+wsgi-intercept>=1.4.1 # MIT License
+
+# releasenotes
+reno>=2.5.0 # Apache-2.0

doc/source/configuration/config.rst

@@ -7,4 +7,4 @@ and compute-hyperv.
 For a sample configuration file, refer to :ref:`config_sample`.
 
 .. show-options::
-   :config-file: etc/compute-hyperv-config-generator.conf
+   :config-file: ../../etc/compute-hyperv-config-generator.conf