Skip to content

feat(ci): say when the schema sync has not landed - #12483

Draft
jd wants to merge 1 commit into
devs/jd/jd/mrgfy-8814-docs-schema-sync-pr-wedges-whenever-an-api-tag-is-removed/sync-schemas-retire-badges-ref-them--9a0e39bbfrom
devs/jd/jd/mrgfy-8814-docs-schema-sync-pr-wedges-whenever-an-api-tag-is-removed/say-schema-sync-landed--6e907e56
Draft

feat(ci): say when the schema sync has not landed#12483
jd wants to merge 1 commit into
devs/jd/jd/mrgfy-8814-docs-schema-sync-pr-wedges-whenever-an-api-tag-is-removed/sync-schemas-retire-badges-ref-them--9a0e39bbfrom
devs/jd/jd/mrgfy-8814-docs-schema-sync-pr-wedges-whenever-an-api-tag-is-removed/say-schema-sync-landed--6e907e56

Conversation

@jd

@jd jd commented Aug 21, 2026

Copy link
Copy Markdown
Member

The Mergify JSON schemas arrive as a pull request from a bot fork, and it
normally merges itself within ten minutes, so nobody watches it. When one
needs a docs-side edit before it can go green — the retired badges tag, whose
sidebar entry had to go with it — the failure is correct and invisible: the
last one sat red for three days while every new schema change was force-pushed
onto the same blocked branch, and the site served a stale API and configuration
reference the whole time.

CI already catches the breakage; nothing was reporting it. A scheduled job now
fails when that pull request has been open for more than three hours, roughly
ten times its usual time to merge, so an ordinary sync never trips it. A
failing scheduled run shows red in the Actions tab and mails whoever last
touched the workflow file, and fixing the sync clears it.

The build-time guard keeps its own job, and its comment no longer claims the
sync bypasses pull request CI — it does not. What the deploy build catches is
the case per-pull-request CI cannot: a sync that retires a tag and an unrelated
edit that links it are each green alone and broken once both are on main. Its
error message now covers a retired tag as well as a renamed one, since telling
the reader to repoint an entry at a slug that no longer exists is a dead end.

MRGFY-8814

Depends-On: #12482

The Mergify JSON schemas arrive as a pull request from a bot fork, and it
normally merges itself within ten minutes, so nobody watches it. When one
needs a docs-side edit before it can go green — the retired `badges` tag, whose
sidebar entry had to go with it — the failure is correct and invisible: the
last one sat red for three days while every new schema change was force-pushed
onto the same blocked branch, and the site served a stale API and configuration
reference the whole time.

CI already catches the breakage; nothing was reporting it. A scheduled job now
fails when that pull request has been open for more than three hours, roughly
ten times its usual time to merge, so an ordinary sync never trips it. A
failing scheduled run shows red in the Actions tab and mails whoever last
touched the workflow file, and fixing the sync clears it.

The build-time guard keeps its own job, and its comment no longer claims the
sync bypasses pull request CI — it does not. What the deploy build catches is
the case per-pull-request CI cannot: a sync that retires a tag and an unrelated
edit that links it are each green alone and broken once both are on main. Its
error message now covers a retired tag as well as a renamed one, since telling
the reader to repoint an entry at a slug that no longer exists is a dead end.

MRGFY-8814

Change-Id: I6e907e5617e318d75718553c48f965b3738e3d80
@jd

jd commented Aug 21, 2026

Copy link
Copy Markdown
Member Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 fix(api): sync the schemas and retire the badges reference with them #12482
2 feat(ci): say when the schema sync has not landed #12483 👈

@mergify
mergify Bot had a problem deploying to Mergify Merge Protections August 21, 2026 15:15 Failure
@mergify

mergify Bot commented Aug 21, 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]
    • all of:
      • author = mergify-ci-bot
      • -head ~= ^docs-agent/

🔴 🔎 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 August 21, 2026 15:17
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