Document the Release Notes build

This adds documentation for the Release Notes build
and how to run the build locally so contributors
know that the gate exists and to run the build
locally before putting changes up for review.

Change-Id: Id2a8d7d96edec5865bc71cf61afa70d13f9977dd
This commit is contained in:
Samuel Matzek 2016-05-12 10:31:36 -05:00
parent 5dca9ed73d
commit 0d3b531de7

View File

@ -166,12 +166,30 @@ Documentation may be built locally by executing:
.. _reStructuredText: http://docutils.sourceforge.net/rst.html .. _reStructuredText: http://docutils.sourceforge.net/rst.html
Release Notes Build
-------------------
Release notes are generated using the `the reno tool`_ and compiled into
HTML using Sphinx.
Release notes may be built locally by executing:
.. code-block:: bash
tox -e releasenotes
.. _the reno tool: http://docs.openstack.org/developer/reno/usage.html
Gating Gating
^^^^^^ ^^^^^^
Every commit to OpenStack-Ansible is verified by OpenStack-CI through the Every commit to OpenStack-Ansible is verified by OpenStack-CI through the
following jobs: following jobs:
* ``gate-openstack-ansible-releasenotes``: This job executes the
`Release Notes Build`_.
* ``gate-openstack-ansible-docs``: This job executes the * ``gate-openstack-ansible-docs``: This job executes the
`Documentation Build`_. `Documentation Build`_.