blob: 9c79a1fbb345d32786b6dfc3ef97d90dd01cfe62 [file] [log] [blame]
Ghanshyam Mann95c410a2020-04-19 17:44:59 -05001============================
2So You Want to Contribute...
3============================
4
5For general information on contributing to OpenStack, please check out the
6`contributor guide <https://docs.openstack.org/contributors/>`_ to get started.
7It covers all the basics that are common to all OpenStack projects: the accounts
8you need, the basics of interacting with our Gerrit review system, how we
9communicate as a community, etc.
10
11Below will cover the more project specific information you need to get started
12with Tempest.
13
14Communication
15~~~~~~~~~~~~~
Ghanshyam Mannd9654da2020-04-22 21:54:19 -050016* IRC channel ``#openstack-qa`` at FreeNode
Ghanshyam Mann95c410a2020-04-19 17:44:59 -050017* Mailing list (prefix subjects with ``[qa]`` for faster responses)
18 http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss
19
20Contacting the Core Team
21~~~~~~~~~~~~~~~~~~~~~~~~
Ghanshyam Mannd9654da2020-04-22 21:54:19 -050022Please refer to the `Tempest Core Team
Ghanshyam Mann95c410a2020-04-19 17:44:59 -050023<https://review.opendev.org/#/admin/groups/42,members>`_ contacts.
24
25New Feature Planning
26~~~~~~~~~~~~~~~~~~~~
27If you want to propose a new feature please read `Feature Proposal Process`_
28Tempest features are tracked on `Launchpad BP <https://blueprints.launchpad.net/tempest>`_.
29
30Task Tracking
31~~~~~~~~~~~~~
32We track our tasks in `Launchpad <https://bugs.launchpad.net/tempest>`_.
33
34If you're looking for some smaller, easier work item to pick up and get started
35on, search for the 'low-hanging-fruit' tag.
36
37Reporting a Bug
38~~~~~~~~~~~~~~~
39You found an issue and want to make sure we are aware of it? You can do so on
40`Launchpad <https://bugs.launchpad.net/tempest/+filebug>`__.
41More info about Launchpad usage can be found on `OpenStack docs page
42<https://docs.openstack.org/contributors/common/task-tracking.html#launchpad>`_
43
44Getting Your Patch Merged
45~~~~~~~~~~~~~~~~~~~~~~~~~
Ghanshyam Mannd9654da2020-04-22 21:54:19 -050046All changes proposed to the Tempest require two ``Code-Review +2`` votes from
47Tempest core reviewers before one of the core reviewers can approve the patch by
Ghanshyam Mann95c410a2020-04-19 17:44:59 -050048giving ``Workflow +1`` vote. More detailed guidelines for reviewers are available
49at :doc:`../REVIEWING`.
50
51Project Team Lead Duties
52~~~~~~~~~~~~~~~~~~~~~~~~
53All common PTL duties are enumerated in the `PTL guide
54<https://docs.openstack.org/project-team-guide/ptl.html>`_.
55
Ghanshyam Mannd9654da2020-04-22 21:54:19 -050056The Release Process for QA is documented in `QA Release Process
57<https://wiki.openstack.org/wiki/QA/releases>`_.
Ghanshyam Mann95c410a2020-04-19 17:44:59 -050058
59.. _Feature Proposal Process: https://wiki.openstack.org/wiki/QA#Feature_Proposal_.26_Design_discussions