Reviewers
Last updated
Was this helpful?
Last updated
Was this helpful?
A reviewer is an individual or Team that is appointed to a pull request to provide feedback on a set of changes. They are notified by e-mail and in the Notifications screen of the Web App if a review has been requested from them.
Pull requests need to be reviewed and approved before getting merged into main
.
Reviewers and contributors can view open pull requests in a few ways.
The easiest gateway into viewing an open PR is to navigate to the Notifications screen and click on an open PR.
Another option is to navigate to the Pull Requests page through the main nav bar. Clicking into the Open part of the toggle will display open pull requests across all repositories and throughout all organizations.
The last method is to navigate to a specific repository and click on the Pull Requests tab. Any open PRs will be listed under the Open side of the toggle.
Both reviewers and contributors can create and engage in a dialogue about the contents of a PR.
To read or add a comment, navigate to the Conversation tab. Here you will see a full history of what has been discussed as it relates to the changes proposed in the PR.
After reviewing all changes, you can add a general and high-level review to the PR.
Click on the Submit Review dropdown and enter your comments.
You can either approve, comment, or request changes using the radio selectors. If you approve the changes, the contributor can continue to merge the PR into main
. Once finished, click the Submit button.
If the filetype under review supports Code Commenting, you can add comments directly on the graphical display. Code Commenting will also initialize the review process.
Navigate to the Files for Review tab, choose an item to comment on, and write your comment. Click the Start Review button to submit your comment.
Continue to add other comments as needed. Once you're finished with all of your comments, click the Submit Review button to finalize your review.