Code Review for Open-Source Projects

Manage large open-source projects by distributing the burden of code review.

Targeted Assignment

Use labels, files, and phased reviews to notify the right people at the right time.

Implement a Hierarchy

Design a process where project owners can step in and approve a PR if others aren't available.

Native Integration

Built around Git and GitHub, users can review with the native tools and personal workflows.

version: 3

pullapprove_conditions:
- condition: "'WIP' not in title and not draft"
  unmet_status: pending
  explanation: "Waiting to send reviews as PR is WIP"

groups:
  global-approvers:
    type: optional
    reviewers:
      teams: [admins]
    reviews:
      request: 0
      required: 1
      reviewed_for: required

  compiler:
    conditions:
    - "'global-approvers' not in groups.approved"
    - "'pkg/compiler/*' in files or 'compiler' in labels"
    reviewers:
      teams: [compiler-owners]
    reviews:
      required: 1

  docs:
    conditions:
    - "'global-approvers' not in groups.approved"
    - "'compiler' in groups.passing"
    - "'*.md' in files or '*docs*' in files"
    reviewers:
      teams: [docs]
    reviews:
      required: 1

Read the Docs Try PullApprove →