Pull Request Reviews
View and comment on pull request reviews from Linear.
Overview
Access GitHub Pull Requests (PRs) from Linear to streamline the code review process.
This feature adds a dedicated Reviews section to your sidebar, where you can see all of your PRs awaiting review as well as PRs that you've been asked to review. You'll be able to view PRs, comment on them, and get notifications in your Inbox whenever a review is requested.
You'll need to open the PR in GitHub to review the code and approve reviews, and will see those changes reflected in Linear.
Basics
Enable Reviews
To enable Reviews, make sure your personal account is connected with GitHub from Settings > Connected Accounts and then toggle on Enable pull request reviews inside Linear.
Display and grouping
By default, PRs are grouped by Responsibility, divided between PRs that are To Do (need your review), Waiting for others or Approved.
Similar to other views in Linear, you can adjust the display settings to pick different groupings and decide whether closed PRs and drafts will show. PRs in Reviews can be grouped by Status, Author, Repository or switched to No Grouping. You can also adjust the display settings to show/hide the Pull Request ID or the avatar of the reviewing user
View PRs
Select a PR to view it. You'll see the PR title, description, and a link to the PR in Github. You can also see a summary of changes and checks associated with the PR.
Open the PR in GitHub to review the full PR and approve or request changes.
Comment on PRs
You'll see all comments related to the PR in the Activity section, including suggested changes from those comments. From here you can create new comments, reply to comments, or react with emoji.
Commenting on a PR will move it from To Do into Waiting for Others until your comment is addressed.
Taking other Actions
Most of the review information is read-only in Linear for the moment, and you'll need to navigate to Github to approve the PR, comment on code inline, or perform actions like requesting other reviewers.
Notifications
With this feature enabled, your inbox notifications will include the following:
- For PR Authors: Notifications for all comments, reviews by others, and check failures on their PRs.
- For PR reviewers: Notifications for review requests as well as comments in PR discussion threads they're participating in.
- Everyone: Notifications about mentions in PRs.