Add release notes job to zuul template
We are not running the release notes job, so are unable to
see the built release notes when they are included in a patch.
Add it as in the other neutron repos.
Also added a similar README.rst as the neutron repo to give
the basic info on release note generation, and fixed up
various issues in the configuration description.
Change-Id: I98ffed3ed77a16bba59cae69a73cb699ddb175fb
diff --git a/.zuul.yaml b/.zuul.yaml
index a2506c7..9aa86b9 100644
--- a/.zuul.yaml
+++ b/.zuul.yaml
@@ -242,3 +242,4 @@
- neutron-tempest-plugin-jobs-queens
- check-requirements
- tempest-plugin-jobs
+ - release-notes-jobs-python3
diff --git a/README.rst b/README.rst
index b3883b8..3d8a49b 100644
--- a/README.rst
+++ b/README.rst
@@ -10,3 +10,4 @@
* Documentation: https://docs.openstack.org/neutron/latest/
* Source: https://git.openstack.org/cgit/openstack/neutron-tempest-plugin
* Bugs: https://bugs.launchpad.net/neutron
+* Release notes: https://docs.openstack.org/releasenotes/neutron-tempest-plugin/
diff --git a/releasenotes/source/README.rst b/releasenotes/source/README.rst
new file mode 100644
index 0000000..a6677ca
--- /dev/null
+++ b/releasenotes/source/README.rst
@@ -0,0 +1,34 @@
+==========================================
+Neutron Tempest Plugin Release Notes Howto
+==========================================
+
+Release notes are a new feature for documenting new features in
+OpenStack projects. Background on the process, tooling, and
+methodology is documented in a `mailing list post by Doug Hellmann <http://lists.openstack.org/pipermail/openstack-dev/2015-November/078301.html>`_.
+
+Writing release notes
+---------------------
+
+For information on how to create release notes, please consult the
+`reno documentation <https://docs.openstack.org/reno/latest/user/usage.html>`__.
+
+Please keep the following in your mind when you write release notes.
+
+* **Avoid using "prelude" section** for individual release notes.
+ "prelude" section is for general comments about the release.
+* **Use one entry per section** (like "feature" or "upgrade").
+ All entries which belong to a same release will be merged and rendered,
+ so there is less meaning to use multiple entries by a single topic.
+
+Maintaining release notes
+-------------------------
+
+.. warning::
+
+ Avoid modifying an existing release note file even though it is related
+ to your change. If you modify a release note file of a past release,
+ the whole content will be shown in a latest release. The only allowed
+ case is to update a release note in a same release.
+
+ If you need to update a release note of a past release,
+ edit a corresponding release note file in a stable branch directly.
diff --git a/releasenotes/source/conf.py b/releasenotes/source/conf.py
index d95fd58..66d6a9e 100644
--- a/releasenotes/source/conf.py
+++ b/releasenotes/source/conf.py
@@ -52,12 +52,12 @@
master_doc = 'index'
# General information about the project.
-project = u'neutron_tempest_plugin Release Notes'
-copyright = u'2017, OpenStack Developers'
+project = u'Neutron Tempest Plugin Release Notes'
+copyright = u'2017, Neutron Tempest Plugin Developers'
# openstackdocstheme options
-repository_name = 'openstack/openstack'
-bug_project = 'neutron_tempest_plugin'
+repository_name = 'openstack/neutron-tempest-plugin'
+bug_project = 'neutron'
bug_tag = ''
# The version info for the project you're documenting, acts as replacement for
@@ -191,7 +191,7 @@
# html_file_suffix = None
# Output file base name for HTML help builder.
-htmlhelp_basename = 'neutron_tempest_pluginReleaseNotesdoc'
+htmlhelp_basename = 'NeutronTempestPluginReleaseNotesdoc'
# -- Options for LaTeX output ---------------------------------------------
@@ -211,9 +211,9 @@
# (source start file, target name, title,
# author, documentclass [howto, manual, or own class]).
latex_documents = [
- ('index', 'neutron_tempest_pluginReleaseNotes.tex',
- u'neutron_tempest_plugin Release Notes Documentation',
- u'OpenStack Foundation', 'manual'),
+ ('index', 'NeutronTempestPluginReleaseNotes.tex',
+ u'Neutron Tempest Plugin Release Notes Documentation',
+ u'Neutron Tempest Plugin Developers', 'manual'),
]
# The name of an image file (relative to this directory) to place at the top of
@@ -242,9 +242,9 @@
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
- ('index', 'neutron_tempest_pluginrereleasenotes',
- u'neutron_tempest_plugin Release Notes Documentation',
- [u'OpenStack Foundation'], 1)
+ ('index', 'NeutronTempestPluginrereleasenotes',
+ u'Neutron Tempest Plugin Release Notes Documentation',
+ [u'Neutron Tempest Plugin Developers'], 1)
]
# If true, show URL addresses after external links.
@@ -257,9 +257,10 @@
# (source start file, target name, title, author,
# dir menu entry, description, category)
texinfo_documents = [
- ('index', 'neutron_tempest_plugin ReleaseNotes',
- u'neutron_tempest_plugin Release Notes Documentation',
- u'OpenStack Foundation', 'neutron_tempest_pluginReleaseNotes',
+ ('index', 'Neutron Tempest Plugin ReleaseNotes',
+ u'Neutron Tempest Plugin Release Notes Documentation',
+ u'Neutron Tempest Plugin Developers',
+ 'NeutronTempestPluginReleaseNotes',
'One line description of project.',
'Miscellaneous'),
]
diff --git a/releasenotes/source/index.rst b/releasenotes/source/index.rst
index 2aa8030..5648f19 100644
--- a/releasenotes/source/index.rst
+++ b/releasenotes/source/index.rst
@@ -1,8 +1,13 @@
-============================================
- neutron_tempest_plugin Release Notes
-============================================
+======================================
+ Neutron Tempest Plugin Release Notes
+======================================
.. toctree::
:maxdepth: 1
unreleased
+
+.. toctree::
+ :maxdepth: 1
+
+ README.rst
diff --git a/setup.cfg b/setup.cfg
index a54cc6c..c6a1fad 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -1,5 +1,5 @@
[metadata]
-name = neutron_tempest_plugin
+name = neutron-tempest-plugin
summary = Tempest plugin for Neutron Project
description-file =
README.rst
@@ -16,8 +16,7 @@
Programming Language :: Python :: 2
Programming Language :: Python :: 2.7
Programming Language :: Python :: 3
- Programming Language :: Python :: 3.3
- Programming Language :: Python :: 3.4
+ Programming Language :: Python :: 3.5
[files]
packages =
@@ -33,11 +32,11 @@
upload-dir = doc/build/html
[compile_catalog]
-directory = neutron/locale
-domain = neutron
+directory = neutron_tempest_plugin/locale
+domain = neutron-tempest-plugin
[update_catalog]
-domain = neutron_tempest_plugin
+domain = neutron-tempest-plugin
output_dir = neutron_tempest_plugin/locale
input_file = neutron_tempest_plugin/locale/neutron_tempest_plugin.pot