So You Want to Contribute…¶
For general information on contributing to OpenStack, please check out the contributor guide to get started. It covers all the basics that are common to all OpenStack projects: the accounts you need, the basics of interacting with our Gerrit review system, how we communicate as a community, etc.
Below will cover the more project specific information you need to get started with Oslo, which includes all of the projects listed on the Oslo wiki.
Communication¶
IRC: #openstack-oslo on OFTC
Mailing list: Messages tagged with [oslo] on openstack-discuss
Meeting: Weekly. Full details on eavesdrop
Contacting the Core Team¶
See The Oslo Team on the wiki.
New Feature Planning¶
Oslo uses a spec process for major new features. See details on the wiki.
Task Tracking¶
We track our tasks in Launchpad.
https://bugs.launchpad.net/oslo
Each individual library also has its own Launchpad project.
If you’re looking for some smaller, easier work item to pick up and get started on, search for the ‘low-hanging-fruit’ tag.
Reporting a Bug¶
You found an issue and want to make sure we are aware of it? You can do so on Launchpad.
How to contribute¶
If you would like to contribute to the development of OpenStack, you must follow the steps in this page:
https://docs.openstack.org/infra/manual/developers.html
Once those steps have been completed, changes to OpenStack should be submitted for review via the Gerrit tool, following the workflow documented at:
https://docs.openstack.org/infra/manual/developers.html#development-workflow
Pull requests submitted through GitHub will be ignored.
Getting Your Patch Merged¶
In general, Oslo requires 2 +2’s in order to merge a patch. Under some circumstances a single +2 may be sufficient. This is generally reserved for repetitive patches such as trivial tox changes that have been pre-approved by the team. Some other circumstances (such as gate blocking bugs) may call for single approval at the discretion of the core team.
Unit tests are preferred for changes that are not already covered by existing unit tests, and will usually help patches merge more quickly.
Project Team Lead Duties¶
PTL duties are documented in the Oslo PTL Guide.
All common PTL duties are enumerated in the PTL guide.
