Skip to content

docs(merge-queue): fix accuracy drift and style across the section - #12207

Merged
mergify[bot] merged 1 commit into
mainfrom
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-accuracy-drift-style-across-section--d3c23f7e
Jul 27, 2026
Merged

docs(merge-queue): fix accuracy drift and style across the section#12207
mergify[bot] merged 1 commit into
mainfrom
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-accuracy-drift-style-across-section--d3c23f7e

Conversation

@jd

@jd jd commented Jul 26, 2026

Copy link
Copy Markdown
Member

First docs-health audit pass over all merge-queue pages. Accuracy fixes
verified against the config JSON schema, the CLI schema, and the engine:

  • github-rulesets: add the missing none value of
    branch_protection_injection_mode (schema enum queue|merge|none)
  • scopes: remove the wrong "set merge_queue_scope to null to
    disable" claim (schema types it non-nullable)
  • batches: "split into two by default" was stale; the engine splits a
    failed batch into max(2, max_parallel_checks) parts
  • queue-modes: isolated-mode batching without scopes fills by
    changed-directory similarity, not pure arrival order; fast-forward
    restriction list was missing squash as an allowed method
  • lifecycle: reference auto_merge_conditions instead of the deprecated
    auto_merge
  • pause: --reason is required, not optional (CLI schema); fix the broken
    freeze anchor to /merge-protections/freeze
  • monitoring: match the dashboard UI text ("Past 3 months")
  • rules and merge-strategies: convert expired dated deprecation notices
    (autoqueue, fork-rebase) to dateless markers per the repo rule

Plus a conservative style pass per the proofread rubrics: banned words,
~50 prose em dashes, throat-clearing intros, promotional filler, and
grammar fixes. Frontmatter descriptions with banned words or em dashes
were also cleaned (quoted where a colon required it).

Part of the first manual docs-health audit (MRGFY-8212).

Co-Authored-By: Claude Fable 5 noreply@anthropic.com

Depends-On: #12206

@jd

jd commented Jul 26, 2026

Copy link
Copy Markdown
Member Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 docs(configuration): fix reference accuracy and style drift #12205
2 docs(workflow): fix action reference accuracy and style drift #12206
3 docs(merge-queue): fix accuracy drift and style across the section #12207 👈
4 docs(commands,merge-protections,migrate): fix broken examples and style #12208
5 docs(ci-insights,test-insights,monorepo-ci): fix wrong commands and claims #12209
6 docs(stacks,integrations,cli,api): fix CLI and integration inaccuracies #12210
7 docs(enterprise,misc): fix inverted Redis TLS instructions and style #12211

@mergify

mergify Bot commented Jul 26, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🟢 All 7 merge protections satisfied — ready to merge.

Show 7 satisfied protections

🟢 ⛓️ Depends-On Requirements

Requirement based on the presence of Depends-On in the body of the pull request

🟢 🤖 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]
    • author = mergify-ci-bot

🟢 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.

@mergify
mergify Bot requested a review from a team July 26, 2026 08:16
@jd
jd marked this pull request as ready for review July 26, 2026 08:20
First docs-health audit pass over all merge-queue pages. Accuracy fixes
verified against the config JSON schema, the CLI schema, and the engine:

- github-rulesets: add the missing `none` value of
  `branch_protection_injection_mode` (schema enum queue|merge|none)
- scopes: remove the wrong "set `merge_queue_scope` to `null` to
  disable" claim (schema types it non-nullable)
- batches: "split into two by default" was stale; the engine splits a
  failed batch into max(2, max_parallel_checks) parts
- queue-modes: isolated-mode batching without scopes fills by
  changed-directory similarity, not pure arrival order; fast-forward
  restriction list was missing `squash` as an allowed method
- lifecycle: reference `auto_merge_conditions` instead of the deprecated
  `auto_merge`
- pause: `--reason` is required, not optional (CLI schema); fix the broken
  freeze anchor to /merge-protections/freeze
- monitoring: match the dashboard UI text ("Past 3 months")
- rules and merge-strategies: convert expired dated deprecation notices
  (autoqueue, fork-rebase) to dateless markers per the repo rule

Plus a conservative style pass per the proofread rubrics: banned words,
~50 prose em dashes, throat-clearing intros, promotional filler, and
grammar fixes. Frontmatter descriptions with banned words or em dashes
were also cleaned (quoted where a colon required it).

Part of the first manual docs-health audit (MRGFY-8212).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Change-Id: Id3c23f7e14e230717281da16da2ca8f2e491ab5b
@jd
jd force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-accuracy-drift-style-across-section--d3c23f7e branch from c045428 to b1bd5e4 Compare July 26, 2026 08:23
@jd
jd force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-action-ref-accuracy-style-drift--2b9d507d branch from da17747 to 151c2d1 Compare July 26, 2026 08:23
@jd

jd commented Jul 26, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial c045428 2026-07-26 08:22 UTC
2 rebase c045428 → b1bd5e4 (rebase only) 2026-07-26 08:22 UTC

@mergify
mergify Bot had a problem deploying to Mergify Merge Protections July 26, 2026 08:23 Failure
JulianMaurin
JulianMaurin previously approved these changes Jul 27, 2026
@mergify
mergify Bot requested a review from a team July 27, 2026 07:30
@mergify
mergify Bot force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-action-ref-accuracy-style-drift--2b9d507d branch from 151c2d1 to 8207564 Compare July 27, 2026 07:32
Base automatically changed from devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-action-ref-accuracy-style-drift--2b9d507d to main July 27, 2026 07:37
@mergify
mergify Bot dismissed JulianMaurin’s stale review July 27, 2026 07:37

The base branch was changed.

@mergify
mergify Bot force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-accuracy-drift-style-across-section--d3c23f7e branch from b1bd5e4 to a377f90 Compare July 27, 2026 07:37
@mergify
mergify Bot deployed to Mergify Merge Protections July 27, 2026 07:37 Active
@mergify
mergify Bot requested a review from a team July 27, 2026 07:48
@mergify

mergify Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

This pull request spent 2 minutes 53 seconds in the queue, including 2 minutes 6 seconds running CI.

Required conditions to merge

@mergify mergify Bot added the queued label Jul 27, 2026
@mergify
mergify Bot merged commit 444bdcd into main Jul 27, 2026
10 checks passed
@mergify
mergify Bot deleted the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-accuracy-drift-style-across-section--d3c23f7e branch July 27, 2026 08:27
@mergify mergify Bot removed the queued label Jul 27, 2026
mergify Bot pushed a commit that referenced this pull request Jul 27, 2026
…le (#12208)

First docs-health audit pass over the commands, merge-protections, and
migration pages. Accuracy fixes verified against the schema and engine:

- migrate/bulldozer: example used the deprecated `auto_merge: true`; now
  `auto_merge_conditions: true`
- merge-protections/custom-rules: fix regex typo `^^feat:`
- merge-protections/examples: quote `"title ~= #[0-9]+"` (the unquoted
  `#` made YAML parse the condition as empty)
- merge-protections/builtin: Depends-On/Merge-After PR-body snippets are
  now `text` fences, not `yaml` (`#123` would be a YAML comment)
- merge-protections/setup: normalize example YAML to 2-space indentation
- commands/rebase and merge-protections/auto-merge: expired dated
  deprecation notices converted to dateless markers per the repo rule
- merge-protections comparison table: emoji cells replaced with No/Yes

All command names, arguments, and default restrictions were verified
against the engine; the roster is accurate.

Plus a conservative style pass per the proofread rubrics: promotional
openers and filler paragraphs, banned words, em dashes, grammar.

Part of the first manual docs-health audit (MRGFY-8212).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Depends-On: #12207
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants