Review pull requests with Graphite

Index

Code review
/
Review pull requests

Review pull requests

Learn how to review pull requests on the Graphite dashboard.

You can be notified that a PR needs your review in Graphite in one of two ways:

Pull requests appear in the Needs Review section of your pull request inbox
Through the Graphite integration for Slack

Start a review

You can start a review by hovering over a line number to leave a comment. Clicking the line number will allow you to leave a comment on a single line, and clicking and dragging across multiple lines will allow you to leave a comment that spans multiple lines of code. Graphite allows you to comment on both changed and unchanged lines of code.

Hover over a line of code to leave a comment.

In the comment field, leave your comment. The commenting box provides a number of markdown formatting options to select from in the footer. You can switch between markdown and preview format for each comment by clicking the "eye" icon near the right corner of each comment box.

One-off or batched comments

Post a comment or add a comment to a review.

When you finish entering your comment, you can click the dropdown on the post thread button to either:

Post thread: this posts the comment immediately. Great for one-off, non-opinionated comments.
Add to review: this will add the comment to a "batch." Once you batch the comment, it will be pending and only visible to you until you've submitted your final review, at which point all of your batched comments will also be submitted.

If you chose to add your comment to your review, the review bar that's pinned to the bottom of the PR will light up to show how many comments you have pending.

Pending comments are indicated by a blue border.

Suggested edits

While reviewing, you can directly leave a suggested code edit to streamline the review process. You can either add these manually yourself, or leverage Graphite AI to turn your plain English suggestion into a code edit - saving both reviewer and author time.

Leave a final review

Once you finish reading through and commenting on the contents of the pull request, you can leave a final review by hovering over the review bar that's pinned to the bottom of the PR page.