docs: add config validate and simulate to configuration docs

[jd]

Document mergify config validate and simulate commands on the
configuration file-format page where they belong. CLI page links
to the config docs instead of duplicating.

Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com

[mergify]

Merge Protections

Your pull request matches the following merge protections and will not be merged until they are valid.

🟢 🤖 Continuous Integration

Wonderful, this rule succeeded.

• 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

Wonderful, this rule succeeded.

• any of:
  • #approved-reviews-by >= 2
  • author = dependabot[bot]
  • author = mergify-ci-bot

🟢 Enforce conventional commit

Wonderful, this rule succeeded.

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

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

🟢 🔎 Reviews

Wonderful, this rule succeeded.

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

🟢 📕 PR description

Wonderful, this rule succeeded.

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

[Copilot]

Pull request overview

Adds documentation for the Mergify CLI’s new mergify config subcommands, helping users validate configuration locally and simulate rule behavior against an existing PR.

Changes:

• Adds mergify config to the CLI “Available Commands” list.
• Documents mergify config validate (local schema validation).
• Documents mergify config simulate (dry-run rule evaluation on a PR).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-04-10 13:37 UTC · Rule: default
• ✅ Checks passed · on draft merge queue: embarking main (81e38d4) and #10987 together #10988
• ✅ Merged — 2026-04-10 13:39 UTC · at 3a356f45bfc502bb5530255e06f3e8c6bc523d10

This pull request spent 2 minutes 38 seconds in the queue, including 2 minutes 17 seconds running CI.

Required conditions to merge

• schedule=Mon-Fri 09:00-17:30[Europe/Paris]
• all of [🛡 Merge Protections rule Enforce conventional commit]:
  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert)(?:\(.+\))?:
    • docs: add config validate and simulate to configuration docs #10987
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by >= 2
      • docs: add config validate and simulate to configuration docs #10987
    • author = dependabot[bot]
      • docs: add config validate and simulate to configuration docs #10987
    • author = mergify-ci-bot
      • docs: add config validate and simulate to configuration docs #10987
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • docs: add config validate and simulate to configuration docs #10987
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • docs: add config validate and simulate to configuration docs #10987
  • #review-requested = 0
    • docs: add config validate and simulate to configuration docs #10987
  • #review-threads-unresolved = 0
    • docs: add config validate and simulate to configuration docs #10987
• 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
        • docs: add config validate and simulate to configuration docs #10987
    • any of:
      • check-success=Cloudflare Pages
      • -head-repo-full-name~=^Mergifyio/
        • docs: add config validate and simulate to configuration docs #10987