> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assert.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Re-review

> Reading only what changed since your last pass

Someone pushes three commits answering your comments. GitHub shows you the whole
diff again and leaves you to remember which parts you already read.

## What counts as your last review

Assert records the hunk ranges you marked reviewed and the commit pair you marked
them at. "Since last review" means since the commit pair where **you** last marked
that file's hunks reviewed.

This is per file and per person. Marking a file or cluster reviewed with <kbd>R</kbd>
is what advances it, independent of whether you submit a verdict to GitHub. Two
reviewers on one pull request each see their own set of new work, and leaving without
submitting still keeps your place.

## Changed, new, and unchanged files

Every file is labeled against your last pass:

| Badge         | Meaning                                                         |
| :------------ | :-------------------------------------------------------------- |
| **Changed**   | Some hunks changed since your last review. Others may not have. |
| **New**       | The file started being changed after your last review.          |
| **Unchanged** | This file's changes have not moved since your last review.      |

<img src="https://mintcdn.com/assertlabs/FvVy5ZggEJSKHhfc/images/re-review/unchanged-since-last-review.png?fit=max&auto=format&n=FvVy5ZggEJSKHhfc&q=85&s=69ab3f0b68fc947d7ed47c0c219b7eac" alt="An unchanged, reviewed file collapsed above a changed file" className="rounded-lg" width="2436" height="212" data-path="images/re-review/unchanged-since-last-review.png" />

An **Unchanged** file can still show line stats, like the one above. It did change in
the pull request — it just has not changed since you last looked at it.

The check on the right is per-file review state, and clicking it toggles:

| Check | State                                             |
| :---- | :------------------------------------------------ |
| Green | Reviewed. Click to mark unreviewed.               |
| Amber | Partially reviewed. Click to mark fully reviewed. |
| Grey  | Not reviewed.                                     |

Files collapse once they are reviewed. Above, the first file is collapsed because it
is fully reviewed, and the second is open because it is only partly reviewed.

## Since last review

A changed file opens on the full change, the way a reviewer arriving fresh sees it.

<img src="https://mintcdn.com/assertlabs/FvVy5ZggEJSKHhfc/images/re-review/changed.png?fit=max&auto=format&n=FvVy5ZggEJSKHhfc&q=85&s=6bfbc575e0e10b60cba0784f6e0b3f1f" alt="A changed file showing the full diff against the pull request base" className="rounded-lg" width="2424" height="620" data-path="images/re-review/changed.png" />

Flip **Since last review** and the emphasis narrows to what arrived after your last
pass. What you already reviewed stays on screen, dimmed, so you keep the surrounding
context.

<img src="https://mintcdn.com/assertlabs/FvVy5ZggEJSKHhfc/images/re-review/changed-since-last-review.png?fit=max&auto=format&n=FvVy5ZggEJSKHhfc&q=85&s=494c0cbb32e79f98cec7d1170eed9b57" alt="The same file with Since last review on, highlighting only the new lines" className="rounded-lg" width="2432" height="618" data-path="images/re-review/changed-since-last-review.png" />

The toggle only appears on files that have something new to show.

If the base branch moved too, review against the
[merge candidate](/reviewing/merge-candidates) to keep the author's new work separate
from what the merge pulled in.
