Participants tab
On this page:
To learn how to customize participants for a P4 Code Review project, watch this video or review the instructions following the video.
The Participants tab shows the following details:
Members
Displays a list of all the project members. This includes users, groups, and projects.
To add a project member:
-
Click Manage members button.
-
Select the Users, Groups, or Projects tab that you wish to add to the project members list.
-
Type in to search the name of a user, group, or project and click Add button.
To delete a project member, click the delete icon against their name.
Owners
Displays a list of all the project owners. Only users can be added as project owners.
The P4 Code Review user cleanup API requires the P4 Code Review user to have ownership privileges on the affected projects and groups. If the P4 Code Review user has insufficient permissions, cleanup for those P4 projects or groups fails. To resolve this, add Super or admin privileges to the P4 Code Review user, or ensure that the user is an owner of the relevant projects and groups.
To add a project owner, click Manage owners button. Type in the name of the user to add to the project owners list. The field auto-suggests users within P4 Server as you type. Click the Add button to add a user to the project owners list.
To delete a project owner, click the delete icon for that user name.
Default reviewers
Displays a list of all the default reviewers. A default reviewer can be a user or a group.
To add a new default reviewer:
-
Click Manage default reviewers button.
-
Select the Users or Groups tab that you wish to add to the default reviewers list.
-
Type in to search the name and click Add button.
-
Click the drop-down box against the user or group name and select your desired option.
To edit your default reviewer preferences for an existing reviewer, click the drop-down box against the user name and select your desired option.
For a user, you can set the vote requirement to Optional or Required. When a group is a default reviewer, it can be set to operate in one of three ways:
-
Optional:
No members of the group are required to approve the review.
-
Require one indicated by a star badge with a 1:
At least one member of the group must up-vote the review to allow the review to be approved. If any member of the group down-votes the review, the review cannot be approved.
-
Required indicated by a star badge:
All members of the group must up-vote the review to allow the review to be approved.
To delete a default reviewer, click the delete icon against their name.
Default reviewers for reviews in multiple projects or branches:
When a review belongs to more than one project or branch:
-
The default reviewers from all the related projects and branches are combined and added to the review.
-
If a reviewer has different vote requirements in different places, the strictest setting is used.
For example:
-
In Project-A, Reviewer X is optional.
-
In Project-B, Reviewer X is optional.
-
In the project branch, Branch-b, Reviewer X is required.
As a result, Reviewer X will be added as a required reviewer on the review.
Mentioning default reviewers
If users or groups are @mentioned in a new changelist description that includes #review, they will be added to the review as reviewers. If any of these reviewers are already specified as default reviewers they will not be added to the review again, the reviewer's most restrictive reviewer option is used for the review.
To retain default reviewers, toggle the Retain default reviewers switch. For more details about retaining default reviewers, see Membership.
Followers
Displays a list of all the followers.
By default, project members and moderators are notified when a new review is started. Project members, moderators, and followers are notified when a change is committed. When a group is a project member or project moderator, all of the members of that group are notified using the same logic as for individual project members and moderators. Any Links in descriptions and comments users and groups, or users and groups who are explicitly added to a review or changelist, receive notifications even if new review/committed review notifications are disabled.
Toggle the following switches at the bottom of the Participants tab to ensure which actions send a notification:
- Email members, moderators, and followers when a review is requested: When a new review is requested for the project, all project members and moderators of the project are added to the email notification list.
- Email members, moderators, and followers when a change is committed: When a change is committed for the project, all project members, project moderators and project followers of this project are added to the email notification list.