Skip to content

chore: freeze docs automation during migration - #349

Merged
jackye1995 merged 1 commit into
mainfrom
jack/freeze-docs-automation
Aug 29, 2026
Merged

chore: freeze docs automation during migration#349
jackye1995 merged 1 commit into
mainfrom
jack/freeze-docs-automation

Conversation

@jackye1995

Copy link
Copy Markdown
Contributor

First step of the documentation migration: stop automation from writing to main unattended while the tree is being restructured.

sync-openapi.yml ran weekly on cron and then self-merged with gh pr merge --squash --admin, bypassing the base-branch status-check policy. That conflicts with the anchor pass, the Geneva removal, and the page moves, all of which need a tree that does not move underneath them.

This removes the schedule trigger and the auto-merge step. workflow_dispatch stays as the manual path — it opens a pull request for a human to merge. The job's if: guard is untouched so restoring the schedule later is a pure re-add of the schedule block.

Two companion actions are manual and happen outside this PR:

  • Mintlify is repointed from main to the deploy-freeze branch (pinned at 03ad18f), so the site keeps serving while deploys pause.
  • The mintlify[bot] catch-up writer is stopped.

Human documentation pull requests continue to merge to main as normal — they queue and ship together at the migration's first cutover.

Suspend the two unattended writers to `main` for the duration of the
documentation migration, so the tree stops moving while it is restructured.

Removes the weekly `schedule` trigger and the `gh pr merge --admin` step,
which merged the sync PR without human review and bypassed the base-branch
status-check policy. `workflow_dispatch` remains as the manual path: it
opens a pull request for a human to merge.

The job's `if:` guard is left as-is so restoring the schedule is a pure
re-add of the `schedule` block.
@jackye1995
jackye1995 merged commit 90117ff into main Aug 29, 2026
1 check passed
@jackye1995
jackye1995 deleted the jack/freeze-docs-automation branch August 29, 2026 23:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant