| Ghanshyam Mann | 4578f98 | 2020-04-19 17:54:56 -0500 | [diff] [blame] | 1 | ============================ |
| 2 | So You Want to Contribute... |
| 3 | ============================ |
| 4 | |
| 5 | For general information on contributing to OpenStack, please check out the |
| 6 | `contributor guide <https://docs.openstack.org/contributors/>`_ to get started. |
| 7 | It covers all the basics that are common to all OpenStack projects: the accounts |
| 8 | you need, the basics of interacting with our Gerrit review system, how we |
| 9 | communicate as a community, etc. |
| 10 | |
| 11 | Below will cover the more project specific information you need to get started |
| 12 | with Devstack. |
| 13 | |
| 14 | Communication |
| 15 | ~~~~~~~~~~~~~ |
| Ghanshyam Mann | 8ea11c2 | 2021-05-31 15:04:29 -0500 | [diff] [blame] | 16 | * IRC channel ``#openstack-qa`` at OFTC. |
| Ghanshyam Mann | 4578f98 | 2020-04-19 17:54:56 -0500 | [diff] [blame] | 17 | * Mailing list (prefix subjects with ``[qa][devstack]`` for faster responses) |
| 18 | http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss |
| 19 | |
| 20 | Contacting the Core Team |
| 21 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
| 22 | Please refer to the `Devstack Core Team |
| 23 | <https://review.opendev.org/#/admin/groups/50,members>`_ contacts. |
| 24 | |
| 25 | New Feature Planning |
| 26 | ~~~~~~~~~~~~~~~~~~~~ |
| 27 | If you want to propose a new feature please read `Feature Proposal Process`_ |
| 28 | Devstack features are tracked on `Launchpad BP <https://blueprints.launchpad.net/devstack>`_. |
| 29 | |
| 30 | Task Tracking |
| 31 | ~~~~~~~~~~~~~ |
| 32 | We track our tasks in `Launchpad <https://bugs.launchpad.net/devstack>`_. |
| 33 | |
| 34 | Reporting a Bug |
| 35 | ~~~~~~~~~~~~~~~ |
| 36 | You found an issue and want to make sure we are aware of it? You can do so on |
| 37 | `Launchpad <https://bugs.launchpad.net/devstack/+filebug>`__. |
| 38 | More info about Launchpad usage can be found on `OpenStack docs page |
| 39 | <https://docs.openstack.org/contributors/common/task-tracking.html#launchpad>`_ |
| 40 | |
| 41 | Getting Your Patch Merged |
| 42 | ~~~~~~~~~~~~~~~~~~~~~~~~~ |
| 43 | All changes proposed to the Devstack require two ``Code-Review +2`` votes from |
| 44 | Devstack core reviewers before one of the core reviewers can approve the patch |
| Martin Kopec | 47a4297 | 2022-11-04 14:31:03 +0100 | [diff] [blame] | 45 | by giving ``Workflow +1`` vote. There are 2 exceptions, approving patches to |
| 46 | unblock the gate and patches that do not relate to the Devstack's core logic, |
| 47 | like for example old job cleanups, can be approved by single core reviewers. |
| Ghanshyam Mann | 4578f98 | 2020-04-19 17:54:56 -0500 | [diff] [blame] | 48 | |
| 49 | Project Team Lead Duties |
| 50 | ~~~~~~~~~~~~~~~~~~~~~~~~ |
| 51 | All common PTL duties are enumerated in the `PTL guide |
| 52 | <https://docs.openstack.org/project-team-guide/ptl.html>`_. |
| 53 | |
| 54 | The Release Process for QA is documented in `QA Release Process |
| 55 | <https://wiki.openstack.org/wiki/QA/releases>`_. |
| 56 | |
| 57 | .. _Feature Proposal Process: https://wiki.openstack.org/wiki/QA#Feature_Proposal_.26_Design_discussions |