This change adds upper constraints for running tox in order
to both solve the issue with sphinx 1.6.1 and pbr breaking
the docs gate [0], as well as helping prevent this from
occuring in the future when a tool updates and ends up
causing issue with other required libraries.
This also adds an exclusion for 1.6.1 in test requirements
as posted here [1].
[0] https://bugs.launchpad.net/pbr/+bug/1691129
[1] http://lists.openstack.org/pipermail/openstack-dev/2017-May/116821.html
Change-Id: I025e75fed186236be51c0fcfb7d35f694b0e42d8
This commit introduces initial infrastructure for building documentation
using the OpenStack's sphinx extension and tox. To demonstrate that
README.md is rewritten into README.rst and should appear in
documentation built by `tox -e docs`.
Partial-Implements: blueprint docs-to-rst
Change-Id: I08ebad1c572e248a8f474e785d3bf7a19dbc4340