Code review

Squash merge

Also known as Squash merge, Squash merge workflow

By WeavePublished 2 min read

Definition

Squash merge is a practical concept in a pull-request workflow that shapes how people examine, discuss, own, or integrate a proposed change.

Why it matters

Good workflow separates author work, reviewer work, automation, and integration. A status label is useful only when people know the next action and the person responsible for it. That clarity makes collaboration easier across teams and time zones.

The useful question is not whether every repository should implement the concept identically. It is whether participants can understand the current state, the requested decision, and the evidence needed to move forward. Naming those boundaries reduces accidental waiting and makes later analysis more honest.

A concrete example

Imagine a team preparing a database migration during a busy release. The request names the data owner, describes rollback, and separates compatibility work from cleanup. A backup reviewer takes the first pass when the primary owner is unavailable.

In that situation, the record should identify the current diff, the relevant owner, and the next action. If the change moves, the author should explain what changed so a reviewer can focus on new risk instead of repeating work without context.

Limits and judgment

Definitions vary across repositories and platforms. Before comparing reports, align the start event, finish event, treatment of revisions, and exception rules. Otherwise a shared label can conceal different processes.

Use the concept as a prompt for better collaboration. Keep technical decisions attached to the change, preserve unresolved concerns, and choose review depth in proportion to the risk rather than to a fixed target.

The canonical focus here is Squash merge; use that boundary when comparing it with related concepts.

How this relates to Weave

Weave can provide review and delivery context around this workflow concept, helping teams compare patterns across changes and teams. The product does not certify correctness, assign responsibility, or infer the full reason behind a human decision.

Explore Engineering intelligence

Sources and further reading

  1. GitHub Pull Request Reviews documentation