aliases

Reviewer aliases can be defined at the root of the CODEREVIEW.toml file. These aliases can be used anywhere a list of strings is expected, such as reviewers, alternates, authors, cc, or labels.

To reference an alias, use the $ prefix.

[aliases]
devs = ["dev1", "dev2", "dev3", "dev4"]

[[scopes]]
name = "app"
reviewers = ["$devs"]

To manage aliases at scale across your organization, you can make use of templates to sync the same aliases to multiple repos.

FAQs

Why not sync with GitHub Teams?

PullApprove doesn't sync directly with GitHub Teams, GitLab Groups, or Bitbucket Groups, because the membership of those lists are not easily visible or auditable along with the rest of the configuration.

Locally referencing these lists also reduces API usage, which is important for running a rate-limited integration at enterprise-scale.

The term aliases was inspired by Kubernetes OWNERS, which uses the same concept.