Replacing Pull Requests with Delta

10 points by caius


typesanitizer

Splitting a big diff across a stack of branches can make it easier to navigate, but the decisions behind the code still need review. Smaller diffs don't supply that context. A reviewer may feed your diff into another agent to help understand it, but that agent has to piece together decisions you already worked through.

Some thoughts:

  1. For large and complex plan, you can write a document first and have people review that in a PR.
  2. The commit message/PR description can be used for high-level decisions (and/or you can use named notes a la GHC).
  3. You can write code comments for non-obvious low-level decisions.
  4. For decisions that are specific to a particular time/things you're not sure about whether they belong in code comments, you can leave an inline comment on the PR for explanation.

Expecting reviewers to trawl through threads of slop breaks the interface of review & the responsibility on the author that comes with it.

Sure, making collaboration have less friction is a good idea. But collaborative development/pair programming and code review are separate things.