Managing code review settings for your team

You can decrease noise for your team by limiting notifications when your team is requested to review a pull request.

Team maintainers and organization owners can configure code review settings.

Code review settings are available with GitHub Team, GitHub Enterprise Server 2.20+, and GitHub Enterprise Cloud. 更多信息请参阅“GitHub's products”。

About code review settings

To reduce noise for your team and clarify individual responsibility for pull request reviews, you can configure code review settings.

  • Team notifications
  • Auto assignment

About team notifications

When you choose to only notify requested team members, you disable sending notifications to the entire team when the team is requested to review a pull request if a specific member of that team is also requested for review. This is especially useful when a repository is configured with teams as code owners, but contributors to the repository often know a specific individual that would be the correct reviewer for their pull request. 更多信息请参阅“关于代码所有者”。

About auto assignment

When you enable auto assignment, any time your team has been requested to review a pull request, the team is removed as a reviewer and a specified subset of team members are assigned in the team's place. 代码审查分配允许您决定在请求团队审查时是通知整个团队,还是只通知一部分团队成员。

When code owners are automatically requested for review, the team is still removed and replaced with individuals unless a branch protection rule is configured to require review from code owners. If such a branch protection rule is in place, the team request cannot be removed and so the individual request will appear in addition.

路由算法

代码审查分配根据两种可能的算法之一自动选择和分配审查者。

循环算法根据最近收到最少审查请求的人员选择审查者,侧重于在团队所有成员之间的轮替,而不管他们目前拥有多少未完成的审查。

负载平衡算法根据每个成员最近的审查请求总数选择审查者,并考虑每个成员未完成的审查数。 负载平衡算法努力确保每个团队成员在任意 30 天内审查相同数量的拉取请求。

任何将状态设置为“忙碌”的团队成员将不会被选中进行审核。 如果所有团队成员都忙碌,拉取请求仍将分配给团队本身。 有关用户状态的更多信息,请参阅“设置状态”。

Configuring team notifications

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. 个人资料菜单中的组织
  2. 单击您的组织名称。 组织列表中的组织名称
  3. 在组织名称下,单击 团队团队选项卡
  4. 在 Teams(团队)选项卡上,单击团队名称。 组织的团队列表
  5. 在团队页面顶部,单击 Settings(设置)团队设置选项卡
  6. In the left sidebar, click Code review Code review button
  7. Select Only notify requested team members. Code review team notifications
  8. 单击 Save changes(保存更改)

Configuring auto assignment

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. 个人资料菜单中的组织

  2. 单击您的组织名称。 组织列表中的组织名称

  3. 在组织名称下,单击 团队

    团队选项卡

  4. 在 Teams(团队)选项卡上,单击团队名称。 组织的团队列表

  5. 在团队页面顶部,单击 Settings(设置)团队设置选项卡

  6. In the left sidebar, click Code review Code review button

  7. 选择 Enable auto assignment(启用自动分配)Auto-assignment button

  8. 在“How many team members should be assigned to review?(应分配多少团队成员进行审查?)”下,使用下拉菜单选择多个要分配给每个拉取请求的审查者。 审查者人数下拉列表

  9. 在“Routing algorithm(路由算法)”下,使用下拉菜单选择要使用的算法。 更多信息请参阅“路由算法”。 路由算法下拉列表

  10. (可选)要始终跳过某些团队成员,请选择 Never assign certain team members(永不分配某些团队成员)。 然后,选择要始终跳过的一个或多个团队成员。 永不分配某些团队成员复选框和下拉列表

  11. (可选)在分配请求时,要将子团队成员作为潜在审查者,请选择 Child team members(子团队成员)

  12. (可选)要根据可分配的成员总数计算已要求审查的成员,选择 Count existing requests(计算现有请求)

  13. (可选)在分配团队成员时,要从团队中删除审核请求,请选择 Team review request(团队审核请求)

  14. 单击 Save changes(保存更改)

Disabling auto assignment

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. 个人资料菜单中的组织
  2. 单击您的组织名称。 组织列表中的组织名称
  3. 在组织名称下,单击 团队团队选项卡
  4. 在 Teams(团队)选项卡上,单击团队名称。 组织的团队列表
  5. 在团队页面顶部,单击 Settings(设置)团队设置选项卡
  6. 选择 Enable auto assignment(启用自动分配)以删除复选标记。 代码审查分配按钮
  7. 单击 Save changes(保存更改)

此文档对您有帮助吗?

隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或者, 了解如何参与。