Playbooks

Teams can’t tell which PRs are theirs

Route each team’s PRs to its own Slack channel, by GitHub team or repository, with its own hours, goal and report.

The problem

One shared channel works for one team. Past that, nobody can tell which PRs are theirs, and a payments PR waits while the frontend team scrolls past it.

Teams also keep different hours, sometimes in different time zones, and expect reviews to start at different speeds.

The setup

  1. Add PullPro to Slack and connect your GitHub organization.
  2. Create public channels like the ones below.
  3. In the PullPro home tab, use Link a channel (then Link another channel) for each one.
  4. Open each channel’s settings and apply the settings on its card.
  5. Open a test PR and mark it ready for review (drafts aren’t posted). Once its checks pass, check where it lands.

Team review channel, one per team

#payments-reviews, #frontend-reviews, …

Only that team’s PRs.

  • Include: the PR author is a member of team payments. If the team owns whole repos, use the PR belongs to repository payments-api instead.
  • Working hours: the team’s own days and hours. They’re saved in the Slack time zone of whoever sets them, so have someone on the team do it.
  • Goals and Reports: the team’s own Time to first review claim and a weekly report.

Variations

  • Each report covers one team, so a manager can follow several. See PullPro for engineering managers.
  • Also add “a selected team is assigned as a reviewer” for the team, so PRs from other teams that request its review land here too, including requests CODEOWNERS adds. If your GitHub team uses code review auto-assignment, GitHub swaps the team request for individual reviewers, so those PRs won’t arrive this way.

Good to know

  • A PR posts to every channel whose rules match, so someone in two GitHub teams shows up in both channels.
  • PRs from people outside every chosen team go nowhere unless another rule matches. A feed channel set to All pull requests catches them.
  • Editing several channels at once in the home tab saves the same settings to all of them, so set each team’s rules and hours one channel at a time.

In the docs: Include rules · Working hours

Try this setup with your team

Free while in beta, with unlimited developers on every plan.