diff --git a/doc/source/contributor/glance-groups.rst b/doc/source/contributor/glance-groups.rst new file mode 100644 index 0000000000..15b6d7a4ff --- /dev/null +++ b/doc/source/contributor/glance-groups.rst @@ -0,0 +1,112 @@ + +.. _glance-groups: + +===================================== +Glance Groups in Gerrit and Launchpad +===================================== + +Glance-related groups in Launchpad +================================== + +.. list-table:: + :header-rows: 1 + + * - group + - what + - who + - where + * - "Glance" team + - not sure, exactly + - an "open" team, anyone with a Launchpad account can join + - `Glance Launchpad `_ + * - "Glance Bug Team" team + - can triage (change status fields) on bugs + - an "open" team, people self-nominate + - `Glance Bug Team `_ + * - "Glance Drivers" team + - not sure, exactly + - Anyone who is interested in doing some work, has a Launchpad + account, and is approved by the current members + - `Glance Drivers Team `_ + * - "Glance Release" team + - Maintains the Launchpad space for Glance, glance_store, + python-glanceclient, and glance-tempest-plugin + - Anyone who is interested in doing some work, has a Launchpad + account, and is approved by the current members + - `Glance Release Team `_ + * - "Glance Core security contacts" team + - can see and work on private security bugs while they are under embargo + - subset of glance-core (the OpenStack Vulnerablity Management Team + likes to keep this team small), so even though the PTL can add people, + you should propose them on the mailing list first. + - `Glance Security Team `_ + +Glance-related groups in Gerrit +=============================== + +The Glance project has total control over the membership of these groups. + +.. list-table:: + :header-rows: 1 + + * - group + - what + - who + - where + * - glance-ptl + - Current Glance PTL + - glance ptl + - `Glance PTL `_ + * - glance-core + - +2 powers in Glance project code repositories + - glance core reviewers + - `Glance Core Team `_ + * - glance-specs-core + - +2 powers in glance-specs repository + - glance-core (plus others if appropriate; currently only glance-core) + - `Glance Specs Core Team `_ + * - glance-tempest-plugin-core + - +2 powers on the glance-tempest-plugin repository + - glance-core plus other appropriate people + - `Glance Tempest Plugin Core Team `_ + +The Glance project shares control over the membership of these groups. If you +want to add someone to one of these groups who doesn't already have membership +by being in an included group, be sure to include the other groups or +individual members in your proposal email. + +.. list-table:: + :header-rows: 1 + + * - group + - what + - who + - where + * - glance-stable-maint + - +2 powers on backports to stable branches + - subset of glance-core (subject to approval by stable-maint-core) plus + the stable-maint-core team + - `Glance Stable Core Team `_ + +NOTE: The following groups exist, but I don't think they are used for anything +anymore. + +.. list-table:: + :header-rows: 1 + + * - group + - where + * - glance-release + - `Glance Release `_ + * - glance-release-branch + - `Glance Stable Release Team `_ + +How Gerrit groups are connected to project repositories +------------------------------------------------------- + +The connection between the groups defined in gerrit and what they +can do is defined in the project-config repository: +https://opendev.org/openstack/project-config + +* ``gerrit/projects.yaml`` sets the config file for a project +* ``gerrit/acls`` contains the config files diff --git a/doc/source/contributor/index.rst b/doc/source/contributor/index.rst index 5be3486c34..3928d76fec 100644 --- a/doc/source/contributor/index.rst +++ b/doc/source/contributor/index.rst @@ -36,6 +36,7 @@ Development Practices blueprints release-notes releasecycle + glance-groups documentation database_migrations .. bugs @@ -73,3 +74,4 @@ Managing the Development Cycle :maxdepth: 1 releasecycle + glance-groups