Stacks

Stacks are Dojo’s unit of code review. A stack is a group of related commits submitted together for review.

What is a stack?

A stack consists of:

• A title describing the overall change
• One or more commits that make up the change
• A status: draft, review, or merged
• Review comments and approvals

Submitting a stack

dojo stack submit --title "Add user authentication"

This takes your recent commits and groups them into a reviewable stack.

Stack lifecycle

draft → review → merged
              ↘ rejected (request changes)

1. Draft — work in progress, not yet ready for review
2. Review — submitted for review, awaiting approval
3. Merged — approved and merged into the main line

Viewing stacks

# List all stacks
dojo stack list

# Show details of a specific stack
dojo stack show 42

Reviewing stacks

# View the diff
dojo review diff --number 42

# Approve
dojo review approve --number 42

# Request changes
dojo review reject --number 42 --message "Please add tests"

# Leave a comment
dojo review comment --number 42 --message "Looks good overall"

Updating a stack

After receiving review feedback, update your commits and push:

# Edit the relevant commit
dojo edit <commit-id>

# Make changes...

# Push updates
dojo sync push

Reviewers can see the delta — what changed since their last review.