Skip to content

docs(workflow): the fork rebase deprecation is not limited to bot_account - #12718

Merged
mergify[bot] merged 2 commits into
mainfrom
devs/jd/jd/recover-actions-corrections/fork-rebase-deprecation-limited-bot-account--bf1f715b
Sep 9, 2026
Merged

docs(workflow): the fork rebase deprecation is not limited to bot_account#12718
mergify[bot] merged 2 commits into
mainfrom
devs/jd/jd/recover-actions-corrections/fork-rebase-deprecation-limited-bot-account--bf1f715b

Conversation

@jd

@jd jd commented Sep 7, 2026

Copy link
Copy Markdown
Member

The caution scoped the deprecation to the rebase action "with bot_account"
on fork pull requests. Rebasing always impersonates a GitHub user: when
bot_account is unset Mergify falls back to the pull request author (or the
command sender), and refuses to run when neither resolves. The deprecation
notice is posted on any fork rebase, so a reader whose configuration sets no
bot_account read the caution as not applying to them when it does — the one
group the callout most needed to reach.

The page's only example was also built on autosquash, which the schema marks
deprecated, so the single worked example on the page taught the option we are
steering people away from. Replaced with a plain label-triggered rebase,
matching the "Squash on Label" example on the squash page.

Nothing is lost by dropping autosquash from the example: the Parameters
table still renders its deprecated badge from the schema, and Rebase
Requirements still documents its effect on the #commits > 1 disjunct.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_019V4gXwb2UucysW4xmB7bAw

@jd

jd commented Sep 7, 2026

Copy link
Copy Markdown
Member Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 docs(workflow): depends-on spans a repository owner, not an organization #12717
2 docs(workflow): the fork rebase deprecation is not limited to bot_account #12718 👈
3 docs(workflow): document when the review action actually posts #12719

@mergify
mergify Bot had a problem deploying to Mergify Merge Protections September 7, 2026 14:36 Failure
@mergify

mergify Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🟢 All 6 merge protections satisfied — ready to merge.

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

🟢 👀 Review Requirements

  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = renovate[bot]
    • all of:
      • author = mergify-ci-bot
      • -head ~= ^docs-agent/

🟢 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 September 7, 2026 14:38
@jd
jd marked this pull request as ready for review September 8, 2026 11:32
Copilot AI lite review requested due to automatic review settings September 8, 2026 11:32

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The updated deprecation callout’s impersonation fallback wording doesn’t fully match the behavior described in the PR description and should be aligned for technical accuracy.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Updates the rebase action documentation to clarify that the fork-rebase deprecation applies to all fork pull requests (not only when bot_account is configured) and refreshes the page’s worked example to avoid relying on a deprecated option.

Changes:

  • Rewords the fork pull-request deprecation callout to remove the misleading bot_account scoping.
  • Replaces the autosquash-based example with a label-triggered rebase example.
File summaries
File Description
src/content/docs/workflow/actions/rebase.mdx Clarifies fork rebase deprecation scope and swaps the example to a non-autosquash configuration.
Review details
  • Files reviewed: 1/1 changed files
  • Comments generated: 1
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/content/docs/workflow/actions/rebase.mdx
jd and others added 2 commits September 8, 2026 14:38
The Pull Request Dependencies section said a `Depends-On:` header could point
at "other repositories with Mergify installed within your organization". The
constraint is the same repository *owner*, which may be a user account rather
than an organization. A reference to another owner is rendered with a
"depends-on conditions must have the same repository owner" warning and never
satisfies.

The section was also silent on what happens to a reference Mergify cannot
resolve — another owner, a repository without Mergify, or a pull request that
does not exist. None of those ever reach the `depends-on` attribute, so the
condition stays unsatisfied and blocks the merge rather than being skipped,
which is the behaviour a reader most needs to be told about.

This brings the page in line with the same rules already documented for the
`depends-on` merge protection in /merge-protections/builtin, which was
corrected and left this page behind.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019V4gXwb2UucysW4xmB7bAw
Change-Id: I790b2c0c6e38ed5eff9ac587378765c72939f264
…ount

The caution scoped the deprecation to the `rebase` action "with `bot_account`"
on fork pull requests. Rebasing always impersonates a GitHub user: when
`bot_account` is unset Mergify falls back to the pull request author (or the
command sender), and refuses to run when neither resolves. The deprecation
notice is posted on any fork rebase, so a reader whose configuration sets no
`bot_account` read the caution as not applying to them when it does — the one
group the callout most needed to reach.

The page's only example was also built on `autosquash`, which the schema marks
deprecated, so the single worked example on the page taught the option we are
steering people away from. Replaced with a plain label-triggered rebase,
matching the "Squash on Label" example on the squash page.

Nothing is lost by dropping `autosquash` from the example: the Parameters
table still renders its `deprecated` badge from the schema, and Rebase
Requirements still documents its effect on the `#commits > 1` disjunct.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019V4gXwb2UucysW4xmB7bAw
Change-Id: Ibf1f715b72dbd21e819305a61b27555cf62874c7
@jd
jd force-pushed the devs/jd/jd/recover-actions-corrections/fork-rebase-deprecation-limited-bot-account--bf1f715b branch from 0ebd0f9 to 00e4c2f Compare September 8, 2026 12:39
@jd

jd commented Sep 8, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial 0ebd0f9 2026-09-08 12:38 UTC
2 content 0ebd0f9 → 00e4c2f Review: the fork-rebase impersonation fallback is the command sender for a command-triggered rebase, and the pull request author otherwise. The callout named only the author. 2026-09-08 12:38 UTC

@mergify
mergify Bot deployed to Mergify Merge Protections September 8, 2026 12:39 Active
@jd

jd commented Sep 8, 2026

Copy link
Copy Markdown
Member Author

Re-pushed to address the review: the deprecation callout now names both impersonation fallbacks — the sender of the rebase command when it is command-triggered, the pull request author when a rule triggered it. Verified against RebaseExecutor.create, which sets the fallback from rule.command_sender in the command case and from the pull request author otherwise.

Compare: 0ebd0f9…00e4c2f

@mergify
mergify Bot requested a review from a team September 9, 2026 06:38
Base automatically changed from devs/jd/jd/recover-actions-corrections/depends-spans-repo-owner-organization--790b2c0c to main September 9, 2026 08:18
@mergify

mergify Bot commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

This pull request spent 3 minutes 27 seconds in the queue, including 2 minutes 50 seconds running CI.

Required conditions to merge

@mergify mergify Bot added the queued label Sep 9, 2026
@mergify
mergify Bot merged commit 31527bf into main Sep 9, 2026
10 of 17 checks passed
@mergify
mergify Bot deleted the devs/jd/jd/recover-actions-corrections/fork-rebase-deprecation-limited-bot-account--bf1f715b branch September 9, 2026 09:19
@mergify mergify Bot removed the queued label Sep 9, 2026
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