Skip to content

docs(ci): describe the queue as configured, not as pending - #11367

Open
andres-pcg wants to merge 1 commit into
mainfrom
docs/merge-freeze-unblock
Open

docs(ci): describe the queue as configured, not as pending#11367
andres-pcg wants to merge 1 commit into
mainfrom
docs/merge-freeze-unblock

Conversation

@andres-pcg

@andres-pcg andres-pcg commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Motivation

The queue documentation merged with #11324 described the state before activation. The cutover has since happened: merge-policy and mergefreeze are required status checks, the merge_queue rule is in the ruleset, Mergify's bypass actor is gone and the app is uninstalled. The book still told readers that neither hold was enforced, and pointed at a list of steps that have all been applied.

Solution

  • The hold section says both checks are required, because they are.
  • Activating the queue becomes Queue configuration: what the ruleset requires and why, keeping the reason the check response timeout is raised from its default of 60 minutes to 180. Unit tests take up to 69, so at the default the queue would stop waiting and drop every entry that touches Rust as assumed-failed while its checks were still running.
  • The Merge Freeze action is named Unblock 1 pull request, which is what the dashboard calls it. The installation's freeze method is confirmed to be Push a status update to all PRs, the one that offers that action, so the instruction to check it first is replaced by the cost that does apply: a status write to every open pull request, at roughly a second each, so a freeze takes a moment to land and is not stuck.
  • Fixes the now-broken anchor in .github/workflows/README.md.

Tests

Documentation only. Verified against the live configuration: six required checks each pinned to its producing app, merge_method: MERGE, build concurrency 5, ALLGREEN, 1–1 entries, 2-minute wait, 180-minute timeout, and no Mergify bypass actor. Checked that no reference to the old #activating-the-queue anchor remains.

AI Disclosure

  • No AI tools were used in this PR
  • AI tools were used: Claude Code, for the documentation changes and verifying them against the live ruleset.

PR Checklist

  • The PR title follows conventional commits format: type(scope): description
  • The PR follows the contribution guidelines.
  • This change was discussed in an issue or with the team beforehand.
  • The solution is tested.
  • The documentation and changelogs are up to date.

@v12-auditor

v12-auditor Bot commented Sep 1, 2026

Copy link
Copy Markdown

Warning

No auditable source files found in this PR's diff.

The hold section still said neither check was required and pointed at a list of
activation steps. Both are required now, and every step in that list has been
applied, so the section becomes a description of the configuration — including
why the check response timeout is raised from its default of 60 minutes to 180:
unit tests take up to 69, so at the default the queue would give up waiting and
drop every entry that touches Rust while its checks were still running.

The release checklist also named the Merge Freeze action "Unfreeze 1 pull request";
the dashboard calls it "Unblock 1 pull request". Its freeze method is confirmed as
the one that offers it, so the caveat about checking first is replaced by the cost
that does apply: a status write per open pull request, at about a second each.
@andres-pcg
andres-pcg force-pushed the docs/merge-freeze-unblock branch from c72034b to f05e99a Compare September 1, 2026 01:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants