feat(docs): document Merge Queue support for GitHub-native stacks

[kozlek]

The queue merges GitHub's own stacked pull requests, and the page said
nothing about them: it described Mergify Stacks throughout and stated that a
stack is recognized only when each pull request carries a Depends-On:
marker, which is not how GitHub-native stacks are detected.

Lead the page with GitHub-native stacks: which members to queue, that they
land one at a time from the bottom up, and the exempt bypass mode they
need. Group the existing sections under a Mergify Stacks heading so their
scope is explicit.

Deep-link the ruleset page's incompatibility note to the new section.

Part of MRGFY-8578

[kozlek]

This pull request is part of a Mergify stack:

#	Pull Request	Link
1	fix(docs): simplify ruleset bypass guidance to one recommendation	#12362
2	feat(docs): document Merge Queue support for GitHub-native stacks	#12361	👈

[mergify]

Merge Protections

🟢 All 6 merge protections satisfied — ready to merge.

Show 6 satisfied protections

🟢 🤖 Continuous Integration

• all of:
  • check-success = build
  • check-success = lint
  • check-success = test
  • any of:
    • check-success = test-broken-links
    • label = ignore-broken-links
  • any of:
    • check-success=Cloudflare Pages
    • -head-repo-full-name~=^Mergifyio/

🟢 👀 Review Requirements

• any of:
  • #approved-reviews-by >= 2
  • author = dependabot[bot]
  • all of:
    • author = mergify-ci-bot
    • -head ~= ^docs-agent/

🟢 Enforce conventional commit

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|internal|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?!?:

🟢 🔎 Reviews

• #changes-requested-reviews-by = 0
• #review-requested = 0
• #review-threads-unresolved = 0

🟢 📕 PR description

• body ~= (?ms:.{48,})

🟢 🚦 Auto-queue

When all merge protections are satisfied, this pull request will be queued automatically.

[Copilot]

Pull request overview

Updates the Merge Queue “Stacked Pull Requests” documentation to cover both Mergify Stacks and GitHub-native stacked PRs (gh-stack), clarifying detection, queueing behavior, and landing order.

Changes:

• Reframes the page intro to distinguish Mergify Stacks vs GitHub-native stacks and scopes the existing sections to Mergify Stacks.
• Adds a new GitHub-native section explaining per-member queueing, bottom-up landing, and GitHub restacking behavior.
• Documents the GitHub ruleset requirement for the exempt bypass mode when merging GitHub-native stacks.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[kozlek]

Revision history

#	Type	Changes	Reason	Date
1	initial	e02a01c		2026-08-12 13:42 UTC
2	content	e02a01c → 437c891		2026-08-12 13:42 UTC
3	content	437c891 → a21059a		2026-08-12 13:54 UTC
4	rebase	a21059a → f18f2f3 (rebase only)		2026-08-12 13:59 UTC
5	rebase	f18f2f3 → e3514e5 (rebase only)		2026-08-12 14:12 UTC
6	rebase	e3514e5 → 66f9391 (rebase only)		2026-08-12 16:36 UTC
7	content	66f9391 → ba7ae9b		2026-08-12 16:48 UTC
8	rebase	ba7ae9b → b6d5b4a (rebase only)		2026-08-12 17:02 UTC
9	rebase	b6d5b4a → a7295f1 (rebase only)		2026-08-13 08:38 UTC

Pull request has been modified.

[mergify]

@kozlek this pull request is now in conflict 😩

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-08-13 10:01 UTC · Rule: default · triggered by merge protections
• ✅ Checks passed · on draft merge queue: checking main (b118e04) and #12361 together #12382
• ✅ Merged — 2026-08-13 10:04 UTC · at a7295f1c1e3df6a383dd763c953f3b54f730fa2d · squash

This pull request spent 2 minutes 52 seconds in the queue, including 2 minutes 15 seconds running CI.

Required conditions to merge

• github-review-approved [🛡 GitHub repository ruleset rule Require pull request for default branch]
  • feat(docs): document Merge Queue support for GitHub-native stacks #12361
• schedule=Mon-Fri 09:00-17:30[Europe/Paris]
• all of [🛡 Merge Protections rule Enforce conventional commit]:
  • title ~= ^(fix|feat|internal|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?!?:
    • feat(docs): document Merge Queue support for GitHub-native stacks #12361
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by >= 2
      • feat(docs): document Merge Queue support for GitHub-native stacks #12361
    • author = dependabot[bot]
      • feat(docs): document Merge Queue support for GitHub-native stacks #12361
    • all of:
      • author = mergify-ci-bot
        • feat(docs): document Merge Queue support for GitHub-native stacks #12361
      • -head ~= ^docs-agent/
        • feat(docs): document Merge Queue support for GitHub-native stacks #12361
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • feat(docs): document Merge Queue support for GitHub-native stacks #12361
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • feat(docs): document Merge Queue support for GitHub-native stacks #12361
  • #review-requested = 0
    • feat(docs): document Merge Queue support for GitHub-native stacks #12361
  • #review-threads-unresolved = 0
    • feat(docs): document Merge Queue support for GitHub-native stacks #12361
• all of [🛡 Merge Protections rule 🤖 Continuous Integration]:
  • all of:
    • check-success = build
    • check-success = lint
    • check-success = test
    • any of:
      • check-success = test-broken-links
      • label = ignore-broken-links
        • feat(docs): document Merge Queue support for GitHub-native stacks #12361
    • any of:
      • check-success=Cloudflare Pages
      • -head-repo-full-name~=^Mergifyio/
        • feat(docs): document Merge Queue support for GitHub-native stacks #12361