Add details on how to contribute

Add collectd-ceilometer specific contrib information
- What needs to be included in a feature?
- How to add a reno entry

Change-Id: I91cf5af30eb0e26695dffd374f796023dd8af099
This commit is contained in:
Emma Foley 2016-12-15 13:11:36 +00:00
parent 53015ad86c
commit 6590b5cc21
2 changed files with 67 additions and 0 deletions

View File

@ -1,3 +1,6 @@
Contributing to Openstack
=========================
If you would like to contribute to the development of OpenStack, you must If you would like to contribute to the development of OpenStack, you must
follow the steps in this page: follow the steps in this page:
@ -15,3 +18,64 @@ Pull requests submitted through GitHub will be ignored.
Bugs should be filed on Launchpad, not GitHub: Bugs should be filed on Launchpad, not GitHub:
https://bugs.launchpad.net/collectd-ceilometer-plugin https://bugs.launchpad.net/collectd-ceilometer-plugin
Contributing to collectd-ceilometer-plugin
==========================================
As well as following the OpenStack contribution guidelines, there are a few
guidelines that should be observed for this project.
Blueprints
----------
Blueprints are generally not required for features. A bug should be opened in
launchpad instead and tagged as "rfe".
Feature development
-------------------
Each feature should consist of a number of components (below), which can be submitted
in separate, dependant patches.
Each patch should function independently, and should work even if the
following patches are not applied.
The patches should include the following:
- Feature enabling code
- For larger features, there might be several smaller patches.
- Unit tests
- Tests should be included with the relevant feature code.
- Documentation
- How does the feature work?
- How do you configure this feature when installing a) manually and b) using
devstack?
- What configuration options were introduced/changed?
- Examples for particular scenarios should be included in the
doc/source/examples/ directory.
- Updates to individual config options should be included in doc/source/usage.rst.
- Deployment code
- At a minimum, deployment code for devstack, including
any relevant config options, should be added.
- Deployment code includes any changes to the given configurations.
- Release note
- A reno entry needs to be included for every change:
http://docs.openstack.org/developer/reno/usage.html#creating-new-release-notes
Bug Fixes
---------
A bug fix will typically be a single patch, with any relevant changes to
documantation, configuration, etc included.
Release notes should be created using the bug number in the following way::
reno new bug-123456
Release notes should reference the bug number and have a brief description
of the bug e.g.::
critical|security|fixes:
- Fixed bug #123456: Authentication token now automatically renews after
expiry.

View File

@ -0,0 +1,3 @@
---
other:
- Added additional details on how to contribute.