From e28442b43695d8cfac502ac979a07ec0ec601dff Mon Sep 17 00:00:00 2001 From: Joshua Hoblitt Date: Wed, 15 Jul 2026 14:47:38 -0700 Subject: [PATCH] docs: limit concurrent open pull requests for contributors without write access MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Ask contributors without write access to keep no more than three pull requests open at the same time, so that maintainer review — the project's limiting resource — is not spread too thin, enforced through the repository's pull request limit. Contributors with write access, who are actively engaged with the project, are not restricted; anyone with a genuine need to exceed the limit can raise it with a maintainer. Signed-off-by: Joshua Hoblitt (cherry picked from commit 83b2c2e488267615bfe5751bd61c39149d64f399) --- AGENTS.md | 3 +++ Documentation/Contributing/development-flow.md | 7 +++++++ 2 files changed, 10 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 2fb01fbb6..e3b210d9c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,6 +30,9 @@ API, because those comments become the CRD descriptions. * Sign off every commit with `git commit -s`. A bot enforces the DCO. * Open pull requests against `master`, from a branch in a fork. Rebase onto upstream; never merge upstream into a branch. +* If you do not have write access, keep no more than three pull requests open at once; the + repository enforces this. It does not apply to contributors with write access. Ask a maintainer + if you have a genuine need to exceed it. * Opening a pull request non-interactively, such as by passing a body to `gh pr create`, skips the template that GitHub would otherwise supply. Read [the template](.github/PULL_REQUEST_TEMPLATE.md) and fill in its checklist regardless. diff --git a/Documentation/Contributing/development-flow.md b/Documentation/Contributing/development-flow.md index 18c2fe321..f3fee5a68 100644 --- a/Documentation/Contributing/development-flow.md +++ b/Documentation/Contributing/development-flow.md @@ -207,6 +207,13 @@ Before opening the PR: * If there are code changes, add unit tests and verify that all unit tests are passing. See [Unit Tests](#unit-tests) below on running unit tests. * Rebase on the latest upstream changes +### Limit concurrent pull requests + +Contributors without write access should keep no more than three pull requests open at the same +time, so that maintainer review — the project's limiting resource — is not spread too thin. The +repository enforces this: with three open, merge or close one before opening the next. If you have a +genuine need to exceed it, raise it with a maintainer first. + ### Regression Testing All pull requests must pass all continuous integration (CI) tests before they can be merged. These tests