Skip to content

docs(stacks): add checkout command and --base option#10985

Open
jd wants to merge 1 commit intomainfrom
devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c
Open

docs(stacks): add checkout command and --base option#10985
jd wants to merge 1 commit intomainfrom
devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c

Conversation

@jd
Copy link
Copy Markdown
Member

@jd jd commented Apr 10, 2026

Document mergify stack checkout for team collaboration (picking up
a teammate's stack locally) and --base option for branching from
non-default branches.

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

Claude-Session-Id: a911b6ad-5466-48a4-b4d3-85198ebc7c28

@mergify mergify bot had a problem deploying to Mergify Merge Protections April 10, 2026 08:55 Failure
Copilot AI review requested due to automatic review settings April 10, 2026 08:55
@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Apr 10, 2026

Merge Protections

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

🔴 👀 Review Requirements

Waiting for:

  • #approved-reviews-by >= 2

or

  • author = dependabot[bot]

or

  • author = mergify-ci-bot
This rule is failing.
  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🔴 🔎 Reviews

Waiting for:

  • #review-requested = 0
  • #review-threads-unresolved = 0
This rule is failing.
  • #review-requested = 0
  • #review-threads-unresolved = 0
  • #changes-requested-reviews-by = 0

🟢 🤖 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/

🟢 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)(?:\(.+\))?:

🟢 📕 PR description

Wonderful, this rule succeeded.
  • body ~= (?ms:.{48,})

@mergify mergify bot requested a review from a team April 10, 2026 08:58
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds documentation for additional Mergify Stacks CLI workflows aimed at team collaboration and non-default branching, expanding the Stacks docset with guidance on checking out an existing stack and creating stacks from an alternative base branch.

Changes:

  • Documented mergify stack checkout as a way to pick up a teammate’s pushed stack locally.
  • Documented mergify stack new --base to start a stack from a non-main base (e.g., a release branch).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
src/content/docs/stacks/team.mdx Adds a new “Working on Someone Else’s Stack” section describing stack checkout.
src/content/docs/stacks/creating.mdx Adds a short snippet showing stack new --base usage for non-default bases.

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

@jd jd force-pushed the devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c branch from ba23c30 to 0b521e2 Compare April 10, 2026 09:25
@mergify mergify bot had a problem deploying to Mergify Merge Protections April 10, 2026 09:26 Failure
@jd jd marked this pull request as ready for review April 10, 2026 09:32
JulianMaurin
JulianMaurin previously approved these changes Apr 10, 2026
@mergify mergify bot requested a review from a team April 10, 2026 09:41
@mergify mergify bot requested a review from a team April 10, 2026 09:47
sileht
sileht previously approved these changes Apr 10, 2026
@jd jd force-pushed the devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c branch from 0b521e2 to 9e321a7 Compare April 10, 2026 10:36
@mergify mergify bot dismissed stale reviews from sileht and JulianMaurin April 10, 2026 10:37

Pull request has been modified.

@mergify mergify bot had a problem deploying to Mergify Merge Protections April 10, 2026 10:37 Failure
@jd jd force-pushed the devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c branch from 9e321a7 to 0e666c8 Compare April 10, 2026 10:44
@mergify mergify bot had a problem deploying to Mergify Merge Protections April 10, 2026 10:44 Failure
@jd jd force-pushed the devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c branch from 0e666c8 to 8ac7d97 Compare April 10, 2026 10:45
@mergify mergify bot had a problem deploying to Mergify Merge Protections April 10, 2026 10:45 Failure
@jd jd force-pushed the devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c branch from 8ac7d97 to 081aa98 Compare April 10, 2026 10:48
@mergify mergify bot had a problem deploying to Mergify Merge Protections April 10, 2026 10:48 Failure
@mergify mergify bot requested a review from a team April 10, 2026 10:51
pair, or continue the work), use `checkout`:

```bash
mergify stack checkout
Copy link
Copy Markdown
Contributor

@JulianMaurin JulianMaurin Apr 10, 2026

Choose a reason for hiding this comment

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

it make no sense to checkout without branch arg

it make me realize that the option is not marked as required at the cli level

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Good catch. Fixed, added --branch argument to the example.

@mergify mergify bot requested a review from a team April 10, 2026 15:02
Document `mergify stack checkout` for team collaboration (picking up
a teammate's stack locally) and `--base` option for branching from
non-default branches.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Change-Id: I16a5449f6585ed4e5e06f02055740c93857dcd6c
Claude-Session-Id: a911b6ad-5466-48a4-b4d3-85198ebc7c28
@jd jd force-pushed the devs/jd/docs/stacks-checkout-base/I16a5449f6585ed4e5e06f02055740c93857dcd6c branch from 081aa98 to 0ba0a7f Compare April 11, 2026 07:21
@mergify mergify bot had a problem deploying to Mergify Merge Protections April 11, 2026 07:21 Failure
@mergify mergify bot requested a review from a team April 11, 2026 08:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Development

Successfully merging this pull request may close these issues.

5 participants