Skip to content

docs(commands,merge-protections,migrate): fix broken examples and style#12208

Open
jd wants to merge 1 commit into
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-accuracy-drift-style-across-section--d3c23f7efrom
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-broken-examples-style--da6166d7
Open

docs(commands,merge-protections,migrate): fix broken examples and style#12208
jd wants to merge 1 commit into
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-accuracy-drift-style-across-section--d3c23f7efrom
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-broken-examples-style--da6166d7

Conversation

@jd

@jd jd commented Jul 26, 2026

Copy link
Copy Markdown
Member

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

@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

🔴 3 of 7 protections blocking · waiting on 👀 reviews and ⛓️ dependency

Protection Waiting on
🔴 ⛓️ Depends-On Requirements ⛓️ dependency
🔴 👀 Review Requirements 👀 reviews
🔴 🔎 Reviews 👀 reviews
🟢 🤖 Continuous Integration
🟢 Enforce conventional commit
🟢 📕 PR description
🟢 🚦 Auto-queue

🔴 ⛓️ Depends-On Requirements

Waiting for

This rule is failing.

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

🔴 👀 Review Requirements

Waiting for

  • #approved-reviews-by >= 2
This rule is failing.
  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🔴 🔎 Reviews

Waiting for

  • #review-requested = 0
This rule is failing.
  • #review-requested = 0
  • #changes-requested-reviews-by = 0
  • #review-threads-unresolved = 0

Show 4 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/

🟢 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)(?:\(.+\))?!?:

🟢 📕 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:17
@jd
jd marked this pull request as ready for review July 26, 2026 08:20
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>
Change-Id: Ida6166d70d93e02dfdf314a0d7fd37b4d0e3aa59
@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-broken-examples-style--da6166d7 branch from b5e5a22 to 4e6ebc6 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 b5e5a22 2026-07-26 08:22 UTC
2 rebase b5e5a22 → 4e6ebc6 (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
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.

1 participant