From e1e8e9de401d083e8565ff5440fe4873105120c5 Mon Sep 17 00:00:00 2001
From: Abhishek Kekane <akekane@redhat.com>
Date: Fri, 18 Jun 2021 14:23:29 +0000
Subject: [PATCH] Doc: Glance group management
Change-Id: If8798525aff5195e77f451dfce6c45cfaf16eaf4
---
doc/source/contributor/glance-groups.rst | 112 +++++++++++++++++++++++
doc/source/contributor/index.rst | 2 +
2 files changed, 114 insertions(+)
create mode 100644 doc/source/contributor/glance-groups.rst
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 <https://launchpad.net/~glance>`_
+ * - "Glance Bug Team" team
+ - can triage (change status fields) on bugs
+ - an "open" team, people self-nominate
+ - `Glance Bug Team <https://launchpad.net/~glance-bugs>`_
+ * - "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 <https://launchpad.net/~glance-drivers>`_
+ * - "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 <https://launchpad.net/~glance-release>`_
+ * - "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 <https://launchpad.net/~glance-coresec>`_
+
+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 <https://review.opendev.org/admin/groups/3a2d24a98c24482a0371a4762ba0c1b3ade078b8,members>`_
+ * - glance-core
+ - +2 powers in Glance project code repositories
+ - glance core reviewers
+ - `Glance Core Team <https://review.opendev.org/admin/groups/1d14a0536e224488ae2c442c499ad16dddcdf8b8,members>`_
+ * - glance-specs-core
+ - +2 powers in glance-specs repository
+ - glance-core (plus others if appropriate; currently only glance-core)
+ - `Glance Specs Core Team <https://review.opendev.org/admin/groups/b922792a1e96d66b0fc3b2cdbb6aaad7ae9eeefe,members>`_
+ * - glance-tempest-plugin-core
+ - +2 powers on the glance-tempest-plugin repository
+ - glance-core plus other appropriate people
+ - `Glance Tempest Plugin Core Team <https://review.opendev.org/admin/groups/0231143f107f488b7525707b3547b7eac26471ec,members>`_
+
+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 <https://review.opendev.org/admin/groups/6a290a73668d7cdefb7bdfdc5a85f9adb61bbaa5,members>`_
+
+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 <https://review.opendev.org/admin/groups/a405991a32b8d5cbc975db4c956cb11d04805192,members>`_
+ * - glance-release-branch
+ - `Glance Stable Release Team <https://review.opendev.org/admin/groups/fe8ee0c76e7a0bf4b33afbb81741ec4daca50ed4,members>`_
+
+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