You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
doc: clarify organization membership flow and expectations for adding CODEOWNERS (#3472)
This PR updates the documentation to match the new organization membership
request process and issue template. It now clearly states that all BCP
maintainers must support plugin-related organization membership requests.
It also clarifies that adding new CODEOWNERS requires agreement from the
existing owners and some evidence of contribution to the plugin.
These changes aim to make expectations clearer and help reduce the
backlog of pending organization membership requests.
Signed-off-by: Beth Griggs <bethanyngriggs@gmail.com>
-[Developer Certificate of Origin](#developer-certificate-of-origin)
27
29
-[API Reports](#api-reports)
28
30
-[Submitting a Pull Request](#submitting-a-pull-request)
@@ -235,34 +237,23 @@ Visit the [Package Metadata documentation](https://backstage.io/docs/tooling/pac
235
237
236
238
This section outlines the process for plugin maintainers to request organization membership in the Backstage community, which is necessary for efficiently managing `CODEOWNERS` in this repository.
237
239
238
-
Plugin maintainers can request organization membership by submitting a request through [this link](https://github.com/backstage/community/issues/new/choose) and filling out the provided form. In the request, they should:
240
+
Plugin maintainers can request organization membership by submitting a request through [this link](https://github.com/backstage/community/issues/new/choose) and filling out the provided form. In the request:
239
241
240
-
- List the plugins they have contributed and/or maintain within the 'Highlighted Contributions' section.
242
+
- If you are requesting membership after migrating a plugin into this repository, include a link to the PR that performed the migration.
243
+
- List the plugins you have contributed to and/or maintain.
241
244
- Ping the [Community Plugins Area Maintainers](https://github.com/backstage/community/tree/main/project-areas/community-plugins#community-plugin-area-maintainers) for review and support of the request.
242
245
243
-
As becoming an organization member provides elevated permissions, addition of new organization members follows a vetting process, while hoping not to create unnecessary barriers for new plugin maintainers. The following criteria are often used for the vetting process:
244
-
245
-
- Is the individual a member of other teams in Backstage?
246
-
- What is the length and consistency of their involvement with Backstage plugins and/or the Backstage community?
247
-
- Are there other contributors or plugin maintainers who work with the individual and can vouch for them?
248
-
- Do they have an employer with a vested interest in the Backstage community?
249
-
250
246
The Community Plugins Area Maintainers will review the request. While the request is being processed, plugin maintainers are encouraged to review and approve PRs related to their plugins, even though it will not yet show up as a formal review in the GitHub UI.
251
247
252
-
**Form Details:**
248
+
Open requests will be routinely reviewed during Community Plugins SIG meetings. Community Plugin Area Maintainers must indicate support before a request is approved. Once approved, a Backstage organization admin will carry out the membership action.
253
249
254
-
-**Name**: Organization Membership Request
255
-
-**Description**: A request to become a Backstage organization member
256
-
-**Title**: Org Member: `<your-github-login>`
257
-
-**Labels**: `org-member-request`
250
+
### Adding Additional CODEOWNERS
258
251
259
-
The form includes fields to confirm adherence to the Code of Conduct, list highlighted contributions, and more. Please ensure you provide:
252
+
New individuals can be added to a plugin’s `CODEOWNERS` entry to help support reviews, issue triage, and ongoing maintenance. To propose an addition, open a PR that updates the plugin's entry in the `CODEOWNERS` file and include a brief justification along with links to relevant contributions (such as authored PRs, reviews, or issue triage).
260
253
261
-
1. The plugins you maintain within the community plugins section.
262
-
2. Links to your notable contributions (PRs, issues, etc.).
263
-
3. A list of other plugin maintainers who can vouch for your request.
254
+
Agreement from the existing `CODEOWNERS` of the plugin is required before the change is approved.
264
255
265
-
Once the form is submitted, the plugin maintainers will review your request and provide feedback or support as needed.
256
+
Ideally, proposed codeowners have already been actively involved with the plugin. Providing this evidence also helps build a foundation for future organization membership requests.
0 commit comments