Review proposed changes
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.
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
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.
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.
After you've added a summary of your review, you have three options:
Request changes
Just add comments
Approve
Note
If you have any pending comments at the time you're leaving your final review, they will all be posted with your final review at once.
Memes and macros
One of the best parts about reviewing PRs in the Graphite app is the ability to use custom memes and macros in your comments, descriptions, and reviews.
Upload new memes
Each organization on Graphite has their own custom meme library, which you can access on the Meme Library
tab of the PR inbox, or by using the G
+ /
keyboard shortcut. To upload a gif or image, click the upload
button and set a name for the meme:
Use custom memes in comments and reviews
To add a meme to your comment or review, you can click the "meme" icon in the footer of the comment box markdown editor to browse your meme library, or use the /
character to search for a meme by name.