
* This patch adds more content to the contributor docs as described at https://governance.openstack.org/tc/goals/selected/ussuri/project-ptl-and-contrib-docs.html Change-Id: I6eea5db63070bd60fe2475f1fd34e43f855f6aa2
3.4 KiB
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 Mistral.
Communication
- IRC channel #openstack-mistral at FreeNode
- Mailing list (prefix subjects with
[mistral]
for faster responses) http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss
Contacting the Core Team
- Renat Akhmerov, PTL (#rakhmerov)
- Eyal Bar-Ilan (#eyalb)
- Oleg Ovcharuk (#vgvoleg)
- Andras Kovi (#akovi)
- Adriano Petrich (#apetrich)
New Feature Planning
If you want to add new functionality to Mistral please file a blueprint by following https://blueprints.launchpad.net/mistral/+addspec
We don't have a strict requirement to write a detailed specification for all new features and rather encourage more agile approach: just file a brief description of a feature in the form of blueprint and then send a patch to review (linking it to the blueprint). However, in some rare cases, like proposing new API or workflow language additions, we need a spec so that the team could fully understand what's going to be done and provide a feedback.
To file a specification for a new feature, send a patch to https://opendev.org/openstack/mistral-specs that adds a new spec file for the needed release cycle (e.g. 'specs/victoria')
The full list of the specs can be seen at https://specs.openstack.org/openstack/mistral-specs/
Task Tracking
We track our tasks in Launchpad: https://bugs.launchpad.net/mistral
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.
Where to Make Code Changes
Mistral has a number of repositories where you can make code changes:
- https://github.com/openstack/mistral
- https://github.com/openstack/python-mistralclient
- https://github.com/openstack/mistral-dashboard
- https://github.com/openstack/mistral-extra
- https://github.com/openstack/mistral-lib
- https://github.com/openstack/mistral-specs
Where to Review Code Changes
- https://review.opendev.org/#/q/mistral
- https://review.opendev.org/#/q/python-mistralclient
- https://review.opendev.org/#/q/mistral-dashboard
- https://review.opendev.org/#/q/mistral-extra
- https://review.opendev.org/#/q/mistral-lib
- https://review.opendev.org/#/q/mistral-specs
Getting Your Patch Merged
Typically a patch can be merged when it has two +2 votes (at least two core members voted +2). In some rare emergency cases we allow one +2 vote before approving it.
A patch cannot be merged if it has at least one negative vote!
Project Team Lead Duties
All common PTL duties are enumerated in the PTL guide.