SYSTEM Cited by 1 source

ReviewStack

ReviewStack is a Meta-built demonstration code-review website (reviewstack.dev) for stack-oriented review of GitHub pull requests. It was announced alongside the 2022-11-15 open-sourcing of the Sapling client.

The pitch: most existing code-review tools (GitHub's PR UI included) "are optimized for reviewing the entire pull request at once instead of individual commits within the pull request" — which defeats the value of a commit stack where each commit is meant to be a small, independently-reviewable unit.

ReviewStack's alternative UX: per-commit conversation and signal on a single page, with dropdown / navigation controls to move between commits in the stack. Example: the post links reviewstack.dev/bolinfest/monaco-tm/pull/39.

Positioning

Framed by Meta as a "demonstration", not a product: "we put together a demonstration website that shows just how intuitive and powerful stacked commit review flows could be." The critique of GitHub's PR review model is more durable than the demo endpoint.

Stub page

First wiki page for ReviewStack. Future sources on stack-oriented code review should link here + to first-class-commit-stack-workflow.

Seen in

• sources/2024-09-10-meta-sapling-source-control-thats-user-friendly-and-scalable — the announcement context. Meta uses stacked commits as its unit of review internally; ReviewStack is the public-facing hint at what that UI looks like.

Related

• systems/sapling-scm — the SCM built around the stack-of-commits workflow.
• systems/github-pull-requests — the system ReviewStack critiques by offering an alternative UI on top of GitHub PR data.
• commit-stack — the commits-as-reviewable-units unit.
• first-class-commit-stack-workflow — the workflow ReviewStack is designed to review.