···2829## the diff soup model
3031-When you create a PR on traditional code-forges (GitHub
32specifically), the UX implicitly encourages you to address
33your code review by *adding commits* on top of your original
34set of changes:
···37 suggestion into your PR
38- GitHub only shows you the diff of all files at once by
39 default
40-- It is difficult to know what changed across force-pushes
4142Consider a hypothetical PR that adds 3 commits:
43···96could do this with git if you are familiar with fixup
97commits or interactive rebasing).
9899-Lets try that again:
100101```
102[c] implement new feature across the board (HEAD)
···161162## interdiff code review on tangled
163164-To really explain how this works, lets start with a [new
165codebase](https://tangled.sh/@oppi.li/stacking-demo/):
166167```
···249├ my set: introduce basic set operations
250~
251252-# lets edit the implementation of `Union`
253$ jj edit mk
254255# hack, hack, hack
···268> there is a logic bug here, the condition should be negated.
269270```
271-# lets edit the implementation of `Difference`
272$ jj edit so
273274# hack, hack, hack
···358```
359360This feature writes `change-id` headers directly into the
361-git commit object, and is visible to code-forges upon push,
362and allows you to stack your PRs on Tangled.
363-364-
···2829## the diff soup model
3031+When you create a PR on traditional code forges (GitHub
32specifically), the UX implicitly encourages you to address
33your code review by *adding commits* on top of your original
34set of changes:
···37 suggestion into your PR
38- GitHub only shows you the diff of all files at once by
39 default
40+- It is difficult to know what changed across force pushes
4142Consider a hypothetical PR that adds 3 commits:
43···96could do this with git if you are familiar with fixup
97commits or interactive rebasing).
9899+Let's try that again:
100101```
102[c] implement new feature across the board (HEAD)
···161162## interdiff code review on tangled
163164+To really explain how this works, let's start with a [new
165codebase](https://tangled.sh/@oppi.li/stacking-demo/):
166167```
···249├ my set: introduce basic set operations
250~
251252+# let's edit the implementation of `Union`
253$ jj edit mk
254255# hack, hack, hack
···268> there is a logic bug here, the condition should be negated.
269270```
271+# let's edit the implementation of `Difference`
272$ jj edit so
273274# hack, hack, hack
···358```
359360This feature writes `change-id` headers directly into the
361+git commit object, and is visible to code forges upon push,
362and allows you to stack your PRs on Tangled.
00