Clicking on a PR in your PR inbox opens up a designated PR page view in the Graphite app. You can edit the title, status, reviewers, labels, and description directly from Graphite (with any changes you make synced to GitHub).
Here's a look at the anatomy of the PR page:
A) PR page title
The left side of the PR page header contains its review status (in this case, changes requested), the title of the PR, the PR#, and the author.
B) PR body/description
Many of our users prefer to edit the body of the PR description in the Graphite app. However, you may still use vi
through the Graphite CLI.
The markdown description editor has a live-preview of your changes, as well as the ability to drag and drop screenshots, screen recordings, GIFs, and emojis.
AI summarize uses GPT3 to automatically generate a summary for your PR based on the contents of the diff. See the editor below:
C) PR review section
The right side of the PR page header is dedicated to PR review functionality. If you're not the author of the PR, you see a button that says add review.
You have the option to merge the PR or stack of PRs, depending on where you are in the stack.
You can also see a version dropdown next to the PR title to toggle and compare various iterations of the PR. Every time a PR is updated, a new version is created to help view history.
D) Information panel
The right toolbar of the PR page is the information panel. By default the PR page shows the General info tab, and also contains a few other important views:
Files (shortcut
F
): Shows the relevant files touched by this PRStack (shortcut
S
): Shows where in the stack this PR is through an interactive interface that allows you to click PR titles to jump between PRsTimeline (shortcut
T
): Shows a chronological sequence of events similar to GitHub, including comments, version updates, and adding or removing reviewersThreads (shortcut
C
): Shows a focused view of in-line code comments (NOT issue-level comments), so you don't have to scroll through the code to find relevant conversations. Click on threads in this view to see the code where the comment was left.
E) [General info tab] PR metadata
Contains PR's status (open, closed, merged), changeset indicator, repository name, branch name, and the parent branch of the PR.
F) [General info tab] Merge conflicts section
This section indicates whether your PR contains merge conflicts or not.
G) [General info tab] CI status section
Shows a live-updating list of active checks being run against the PR. The header indicates whether the checks are in progress, passing or failing, and provides the option to cancel or rerun checks.
H) [General info tab] Review status section
Shows a list of the PR's requested reviewers, the review status of the PR, and the ability to add/remove/re-request reviewers.
I) Diff view
By default Graphite assumes a split view, where changes to the PR are shown on the right, in comparison to the base view on the left. If you're more comfortable with a unified view, you can adjust this in the ...
menu on the header of the PR.
J) In-line comments
Leave comments on the diff in line by clicking and dragging on line numbers. These will surface in the timeline or threads view of the PR.
K) Labels
These are the labels associated with the PR.
Warning
We're rapidly iterating on our code review interface. Expect frequent updates as we refine the experience. If there's something in the UI that isn't clarified in this documentation, please reach out in the community slack.