Collaborating with PullRequest Reviewers
When a pull or merge request is assigned to a PullRequest reviewer or team of reviewers, they'll typically be assigned to it until it is merged, closed, or PullRequest network review is canceled.
After review feedback is posted by PullRequest, our reviewers can revisit it to answer your questions and review follow-up change commits.
PullRequest reviewers have access to:
- The pull/merge request diff and the contents of the files involved.
- Metadata including the pull/merge request title, description, author username, branch names, event timestamps, and commit history.
- In some cases, other files in the repository can be referenced via a search tool if this functionality is enabled by the account owner.
- Your repository's
- Any dependency management files such as
package.jsonbelonging to the repository.
- These are referenced so reviewers can provide recommendations based on things like the version of a framework being used.
- Any project-level notes provided by your organization.
Just like for members of any development team reviewing teammates' code, a thorough description of the change, the intent of the changes, and any other relevant information will help PullRequest reviewers provide great feedback and suggestions.
This includes screenshots!
The PullRequest platform notifies reviewers whenever important updates are made. These include:
- Comments that you've posted that require their attention.
- New commits are pushed to address feedback.
- When you request the changes are reviewed again.
PullRequest reviewers will receive a notification that they've been mentioned in a comment in several ways.
If you reply to a reviewer in an inline thread, any reviewer that participated in the thread will be notified.
Reviewers will be alerted when you reply to one of their comments
If you post a comment that includes the reviewer's display name or string
pullrequest(all one word, case insensitive) reviewers will be notified of your comment.
Mentioning `pullrequest` or a reviewer's display (if assigned to the review) will send alerts to reviewers.
When you push additional commits to a pull or merge request branch that "outdate" comments posted by reviewers, they'll receive a notification that you've made a change that likely addressed one of their comments and that they should circle back and verify the new state.
Pushing a commit that addresses a reviewer's comment will alert the reviewer,
After at least one feedback submission has been posted to your pull or merge request by reviewers in the network, you can send a notification to any reviewers assigned asking to re-review the changes.
This is useful if you've updated the branch to include additional changes that would otherwise not alert reviewers.
Click "Notify reviewers of updates" to send a notification to assigned reviewers.