Jump to: navigation, search

Difference between revisions of "NeutronPolicies"

(Core Members)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
Note: These are moving in-tree. You can find most of these now available [https://github.com/openstack/neutron/tree/master/doc/source/policies here].
 +
 
This page tracks all policies and procedures for working within the OpenStack Neutron Project.
 
This page tracks all policies and procedures for working within the OpenStack Neutron Project.
  
 
== Blueprints ==
 
== Blueprints ==
The Neutron team uses the [http://git.openstack.org/cgit/openstack/neutron-specs neutron-specs] repository for it's specification reviews. Detailed information on the process is found [https://wiki.openstack.org/wiki/Blueprints#Neutron here].
+
Information on BPs can be found in-tree [https://github.com/openstack/neutron/blob/master/doc/source/policies/blueprints.rst here].
 +
 
 +
It's worth noting that at the start of each cycle, any BP which did not make it in the release will need to be resubmitted and approved for the next cycle.
  
 
== Bugs ==
 
== Bugs ==
 
+
A detailed description of the Neutron bug processes, including the mention of the current Neutron Bug Czar, is maintained in-tree [https://github.com/openstack/neutron/blob/master/doc/source/policies/bugs.rst here].
== Code Reviews ==
 
  
 
== Contributor Onboarding ==
 
== Contributor Onboarding ==
 +
All information for new contributors is documented in-tree [https://github.com/openstack/neutron/blob/master/doc/source/policies/contributor-onboarding.rst here].
  
 
== Core Members ==
 
== Core Members ==
The [https://review.openstack.org/#/admin/groups/38,members Neutron Core Team] is responsible for merging changes into the following repositories:
+
Information on existing cores, becoming a core, removing a core, and core expectations is available in-tree [https://github.com/openstack/neutron/blob/master/doc/source/policies/core-reviewers.rst here].
* openstack/neutron
 
** http://git.openstack.org/cgit/openstack/neutron/tree/neutron/service.py
 
* openstack/python-neutronclient
 
** https://git.openstack.org/cgit/openstack/python-neutronclient/
 
  
While everyone is encouraged to review changes for these repositories, neutron-core has the ability to +2/-2, as well as +A changes to these repositories.
+
== Gate Failure Triage ==
 +
Gate failure triage is documented in-tree [https://github.com/openstack/neutron/blob/master/doc/source/policies/gate-failure-triage.rst here].
  
=== Adding or Removing Members ===
+
== Meetings ==
A new member to neutroin-core may be proposed at any time to the openstack-dev mailing list. Typically the PTL will propose a new member after discussions with the core team. Once a proposal has been made, five existing neutron-core members must respond to the email with a +1. Another neutron-core member can vote -1 to veto the nomination of the proposed core team member.
+
The Neutron team and sub-teams make extensive use of IRC for meetings. The current list of meetings can be found [https://wiki.openstack.org/wiki/Meetings#OpenStack_Networking_.28Neutron.29 here]. Most sub-teams have weekly meetings, with rollup status reporting back to the weekly Neutron team meeting.
  
The PTL may remove a member from neutron-core at any time. Typically when a member has decreased their involvement with the project through a drop in reviews and participation in general project development, the PTL will propose their removal and remove them. Members who have previously been core may be fast-tracked back into core if their involvement  picks back up.
+
== Plugins ==
 +
The [[NeutronPlugins]] page documents all interactions around plugins. The [http://stackalytics.com/report/driverlog?project_id=openstack%2Fneutron&vendor=&release_id= DriverLog] page for Neutron has additional information for Neutron plugins.
  
=== Membership Expectations ===
+
== Reviews ==
Members of neutron-core have the following expectations:
+
Policies around both code and specification reviews for Neutron are maintained in-tree [https://github.com/openstack/neutron/blob/master/doc/source/policies/code-reviews.rst here].
* Attendance at the weekly Neutron meeting on IRC.
 
* Participation in neutron discussions on the mailing list, as well as in-channel in #openstack-neutron.
 
* Participation in neutron related design summit sessions at the summits.
 
 
 
In addition to the above, code reviews are a critical. Neutron follows the documented OpenStack [https://wiki.openstack.org/wiki/ReviewChecklist code review guidelines]. We encourage all people to review neutron patches, but cores are required to maintain a level of review numbers relatively close to other cores. There are no hard statistics around code review numbers, but in general we use 30, 60, and 90 day stats when examining review stats:
 
* http://stackalytics.com/report/contribution/neutron/30
 
* http://stackalytics.com/report/contribution/neutron/60
 
* http://stackalytics.com/report/contribution/neutron/90
 
 
 
There are soft-touch items around being a core as well. Gaining trust with the existing core team is important. Being able to work together with the existing team is critical as well. Being a core means spending a significant amount of time with the existing core team on IRC, the mailing list, and reviews. Ensuring you participate and engage here is critical to becoming a core.
 
 
 
== Gate Failure Triage ==
 
  
 
== Sub Teams ==
 
== Sub Teams ==
This is a list of the currently operating Neutron sub-teams. If you would like to form a new Neutron sub-team, please attend our weekly [https://wiki.openstack.org/wiki/Network/Meetings meeting] and propose your team there. You can also send out an email to the openstack-dev mailing list. If a sub-team has completed it's work and has wound down, these will be removed from the list below.
+
The [[NeutronSubTeams]] page details all of the various sub-teams which operate under Neutron. These sub-teams are responsible for chunks of Neutron. Neutron is a large project, and there are many faucets involved. Having sub-teams is a way to delegate roles and responsibilities around the operational and development aspects of Neutron. The role of a sub-team is as follows:
 
+
* Triage, track and close bugs in the sub-team area.
{| class="wikitable"
+
* Report status back to the weekly Neutron meeting.
|-
+
* Drive BPs in the sub-team area.
! Sub-team !! Lead Name and IRC handle !! Meeting Page !! Status Page
+
* [rkukura] Can we include a somewhat formal pre-review responsibility, where subteam members need to get some number of +1s on each patch before the core reviewers are asked to review the patches?
|-
 
| Advanced Services || Sumit Naiksatam (snaiksat) || https://wiki.openstack.org/wiki/Meetings/AdvancedServices ||
 
|-
 
| DB Migrations || Henry Gessau (HenryG) || https://wiki.openstack.org/wiki/Meetings/NeutronDB ||
 
|-
 
| Distributed Virtual Router (DVR) || Swaminathan Vasudevan (Swami) || https://wiki.openstack.org/wiki/Meetings/Distributed-Virtual-Router ||
 
|-
 
| FWaaS || Sumit Naiksatam (snaiksat) || https://wiki.openstack.org/wiki/Meetings/FWaaS ||
 
|-
 
| Group-Based Policy || Sumit Naiksatam (snaiksat) || https://wiki.openstack.org/wiki/Meetings/Neutron_Group_Policy ||
 
|-
 
| IPv6 || Sean Collins (sc68cal) || https://wiki.openstack.org/wiki/Meetings/Neutron-IPv6-Subteam ||
 
|-
 
| L3 || Carl Baldwin (carl_baldwin) || https://wiki.openstack.org/wiki/Meetings/Neutron-L3-Subteam ||
 
|-
 
| LBaaS || Kyle Mestery (mestery) || https://wiki.openstack.org/wiki/Network/LBaaS ||
 
|-
 
| ML2 || Robert Kukue (rkukura) and Sukhdev Kapur (Suhkdev) || https://wiki.openstack.org/wiki/Meetings/ML2 ||
 
|-
 
| nova-network parity || Mark McClain (markmcclain) || ||
 
|-
 
| QoS || Sean Collins (sc68cal) || ||
 
|}
 
  
 
== Third Party Testing ==
 
== Third Party Testing ==
 +
Please see the [[NeutronThirdPartyTesting]] page for details.

Latest revision as of 17:48, 6 March 2015

Note: These are moving in-tree. You can find most of these now available here.

This page tracks all policies and procedures for working within the OpenStack Neutron Project.

Blueprints

Information on BPs can be found in-tree here.

It's worth noting that at the start of each cycle, any BP which did not make it in the release will need to be resubmitted and approved for the next cycle.

Bugs

A detailed description of the Neutron bug processes, including the mention of the current Neutron Bug Czar, is maintained in-tree here.

Contributor Onboarding

All information for new contributors is documented in-tree here.

Core Members

Information on existing cores, becoming a core, removing a core, and core expectations is available in-tree here.

Gate Failure Triage

Gate failure triage is documented in-tree here.

Meetings

The Neutron team and sub-teams make extensive use of IRC for meetings. The current list of meetings can be found here. Most sub-teams have weekly meetings, with rollup status reporting back to the weekly Neutron team meeting.

Plugins

The NeutronPlugins page documents all interactions around plugins. The DriverLog page for Neutron has additional information for Neutron plugins.

Reviews

Policies around both code and specification reviews for Neutron are maintained in-tree here.

Sub Teams

The NeutronSubTeams page details all of the various sub-teams which operate under Neutron. These sub-teams are responsible for chunks of Neutron. Neutron is a large project, and there are many faucets involved. Having sub-teams is a way to delegate roles and responsibilities around the operational and development aspects of Neutron. The role of a sub-team is as follows:

  • Triage, track and close bugs in the sub-team area.
  • Report status back to the weekly Neutron meeting.
  • Drive BPs in the sub-team area.
  • [rkukura] Can we include a somewhat formal pre-review responsibility, where subteam members need to get some number of +1s on each patch before the core reviewers are asked to review the patches?

Third Party Testing

Please see the NeutronThirdPartyTesting page for details.