snapshot of https://github.com/zulip/zulip.git @ 48c69911c7dd4e03b20552eb3bd77ad8151c1357 (2026-09-15)

docs/git/reviewing.md

@@ -0,0 +1,64 @@
+# Review changes
+
+**Note** - The following section covers reviewing changes on your local
+clone. Please read the section on [code reviews][zulip-rtd-review] for a guide
+on reviewing changes by other contributors.
+
+## Changes on (local) working tree
+
+Display changes between index and working tree (what is not yet staged for commit):
+
+```console
+$ git diff
+```
+
+Display changes between index and last commit (what you have staged for commit):
+
+```console
+$ git diff --cached
+```
+
+Display changes in working tree since last commit (changes that are staged as
+well as ones that are not):
+
+```console
+$ git diff HEAD
+```
+
+## Changes within branches
+
+Use any git-ref to compare changes between two commits on the current branch.
+
+Display changes between commit before last and last commit:
+
+```console
+$ git diff HEAD^ HEAD
+```
+
+Display changes between two commits using their hashes:
+
+```console
+$ git diff e2f404c 7977169
+```
+
+## Changes between branches
+
+Display changes between tip of `topic` branch and tip of `main` branch:
+
+```console
+$ git diff topic main
+```
+
+Display changes that have occurred on `main` branch since `topic` branch was created:
+
+```console
+$ git diff topic...main
+```
+
+Display changes you've committed so far since creating a branch from `upstream/main`:
+
+```console
+$ git diff upstream/main...HEAD
+```
+
+[zulip-rtd-review]: ../contributing/code-reviewing.md