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