Skip to content

docs(stacks): stop calling GitHub-native stack registration experimental - #13152

Open
jd wants to merge 1 commit into
mainfrom
devs/jd/jd/gh-stack-experimental-caveat/stop-calling-github-native-stack-registration--f9ad66bf
Open

jd wants to merge 1 commit into
mainfrom
devs/jd/jd/gh-stack-experimental-caveat/stop-calling-github-native-stack-registration--f9ad66bf

Conversation

@jd

@jd jd commented Oct 2, 2026 •

Copy link
Copy Markdown
Member

Registering a stack with GitHub's stacking API is no longer experimental:
mergify stack push does it by default, and the CLI is dropping the word
from its own help text. The setup page still said "(experimental)" in the
Git config table and "The CLI marks the registration itself as experimental"
in the note below it. Both are gone.

The note also said the CLI skips the registration "silently" where the API
isn't available, which was never accurate: the push reports
not registered on GitHub on that row and writes the Depends-On: markers
back into the pull request descriptions, then succeeds as usual. The note
now says that.

The comparison with gh-stack already describes the registration without the
caveat, and no other docs page calls it experimental.

This replaces #13149, which went the other way and restored the caveat.

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

Copilot AI balanced review requested due to automatic review settings October 2, 2026 19:13
@mergify
mergify Bot had a problem deploying to Mergify Merge Protections October 2, 2026 19:13 Failure
@mergify

mergify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

Merge Protections

🔴 2 of 5 protections blocking · waiting on 👀 reviews

Protection Waiting on
🔴 👀 Review Requirements 👀 reviews
🔴 🔎 Reviews 👀 reviews
🟢 Enforce conventional commit —
🟢 📕 PR description —
🟢 🚦 Auto-queue —

🔴 👀 Review Requirements

Waiting for

  • #approved-reviews-by >= 1
This rule is failing.
  • any of:
    • #approved-reviews-by >= 1
    • author = dependabot[bot]
    • author = renovate[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 3 satisfied protections

🟢 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.

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.

Copilot review overview

🟡 Changes recommended

The fallback note incorrectly says registration is skipped silently despite the CLI reporting its status.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Updates Stacks setup documentation to remove the experimental label from GitHub-native registration.

Changes:

  • Removes the experimental caveat.
  • Retains fallback behavior guidance.
File Description
src/​content/​docs/​stacks/​setup.mdx Updates GitHub-native registration status and guidance.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/content/docs/stacks/setup.mdx Outdated
@mergify
mergify Bot requested a review from a team October 2, 2026 19:16
Registering a stack with GitHub's stacking API is no longer experimental:
`mergify stack push` does it by default, and the CLI is dropping the word
from its own help text. The setup page still said "(experimental)" in the
Git config table and "The CLI marks the registration itself as experimental"
in the note below it. Both are gone.

The note also said the CLI skips the registration "silently" where the API
isn't available, which was never accurate: the push reports
`not registered on GitHub` on that row and writes the `Depends-On:` markers
back into the pull request descriptions, then succeeds as usual. The note
now says that.

The comparison with gh-stack already describes the registration without the
caveat, and no other docs page calls it experimental.

This replaces #13149, which went the other way and restored the caveat.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Change-Id: If9ad66bf39535464876f097312368352247fc9c4
@jd
jd force-pushed the devs/jd/jd/gh-stack-experimental-caveat/stop-calling-github-native-stack-registration--f9ad66bf branch from e972cda to 48dd436 Compare October 2, 2026 19:30
@jd

jd commented Oct 2, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial e972cda 2026-10-02 19:30 UTC
2 content e972cda → 48dd436 address review: the registration is not skipped silently — the push reports 'not registered on GitHub' and restores the Depends-On markers 2026-10-02 19:30 UTC

@jd

jd commented Oct 2, 2026

Copy link
Copy Markdown
Member Author

Re-pushed: the note no longer says the registration is skipped "silently". Where the API is unavailable, the push reports not registered on GitHub and writes the Depends-On: markers back; the note now says that. The commit message is updated to match.

https://github.com/Mergifyio/docs/compare/e972cda8b7c7a423aeb327e0c6d26f9a881ab0ce..48dd4367e55b

@mergify
mergify Bot had a problem deploying to Mergify Merge Protections October 2, 2026 19:31 Failure
@jd
jd marked this pull request as ready for review October 3, 2026 14:59

This branch had an error being deployed

1 failed deployment
Mergify Merge Protections — 48dd4367 Deployed Oct 2, 2026 by mergify[bot]
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.

2 participants