Add Release Notes to documentation

We're building the sdist to be able to add PBR's changelog in its
docs, so may as well publish the Release Notes document it builds
too.

Change-Id: Icd1b4ae04de8034bc15db87be457751e70e26f6d

.gitignore

@@ -9,6 +9,8 @@ doc/source/reference/api/
 
 # Files created by releasenotes build
 releasenotes/build
+releasenotes/notes/reno.cache
+RELEASENOTES.rst
 
 # Packages/installer info
 *.egg

README.rst

@@ -34,6 +34,7 @@ them as quickly as possible.
 * Documentation: https://docs.openstack.org/pbr/latest/
 * Source: https://opendev.org/openstack/pbr
 * Bugs: https://bugs.launchpad.net/pbr
+* Release Notes: https://docs.openstack.org/pbr/latest/user/releasenotes.html
 * ChangeLog: https://docs.openstack.org/pbr/latest/user/history.html
 
 .. _d2to1: https://pypi.python.org/pypi/d2to1

doc/source/user/index.rst

@@ -9,4 +9,5 @@
    packagers
    semver
    compatibility
+   releasenotes
    history

doc/source/user/releasenotes.rst

@@ -0,0 +1,6 @@
+===============
+ Release Notes
+===============
+
+.. include:: ../../../RELEASENOTES.rst
+  :start-line: 4

tox.ini

@@ -26,8 +26,8 @@ deps =
   -r{toxinidir}/doc/requirements.txt
 commands =
   rm -rf doc/build doc/source/reference/api
+  python setup.py sdist
   sphinx-build -W -b html doc/source doc/build/html {posargs}
-usedevelop = False
 
 [testenv:releasenotes]
 whitelist_externals = rm