This is the new PullApprove v3! Completely redesigned and rebuilt. You can read more about it here or log in to v2 here.

Reviewers

This is where you specify the who is part of the review group. You can list out their usernames, or use your GitHub teams as an alias.

When the group is activated, some or all of these users will be "requested" to review the PR (using the built-in GitHub review requests). PullApprove does not use the "team" requests in GitHub, because we want to give you more control over how many people on that team are actually requested and receive emails/notifications.

See the reviews section for more info on how review requests are sent, and determining how many approvals are required.

reviewers:
  users:
  - example1
  - example2

  teams:
  - teamexample1

Require all pending review requests be approved

By not specifying any users or teams, PullApprove won't send out any review requests but can still be told to check any pending review requests that exist, including those added manually by you or your team on GitHub. This makes it easy to allow people to request their own reviewers, and ensure that a PR is not approved until all (or a specific number) of the review requests are fulfilled.

groups:
  all_requests:
    reviews:
      # -1 will require that all pending requests are approved
      required: -1

You can also use the same behavior to specify that a minimum number of approvals are given for a PR, regardless of who they come from.

groups:
  min_global_approvals:
    reviews:
      # need 10 approvals, but it doesn't matter who gives them
      required: 10