Introduction

Welcome to PullPro, the Slack app designed to streamline your pull request (PR) review process. By integrating GitHub with Slack, PullPro ensures that your team stays on top of code reviews, enhancing collaboration and productivity.

What is PullPro?

PullPro is a Slack application that automates the sharing and review coordination of GitHub pull requests within your team's Slack channels. When a PR is marked as ready for review, it is automatically posted to a designated Slack channel, allowing team members to claim it directly from Slack.

An illustration depicting a collaborative team reviewing code efficiently using PullPro.

Key Features

  • Automatic PR Posting: PRs marked as ready for review are automatically shared in the appropriate Slack channels based on configurable routing settings.
  • Easy Claiming and Viewing: A synopsis of the PR is provided right in Slack, with easy buttons to claim or open the PR on GitHub.
  • Reminders and Notifications: Reminders for unclaimed PRs are sent automatically and individuals are directly notified to keep the review process moving.
  • Metrics and Reporting: Receive recurring reports with statistics on PR review times, the number of PRs reviewed, and team member participation.

Why Use PullPro

Efficient code reviews are essential for maintaining code quality and accelerating development cycles. PullPro brings code review coordination into the communication hub your team already uses — Slack — making it easier to:

  • Increase Efficiency: Automated reminders and notifications ensure that PRs are reviewed promptly.
  • Track Performance: Metrics and reports help teams understand their review process and identify areas for improvement.
  • Improve Collaboration: Coordinate reviews and stay up to date on your team's work all in Slack.
  • Enhance Accountability: A transparent review processes encourage team members to actively participate.

Philosophy

At PullPro, we believe in fostering a proactive and collaborative code review culture. The app works best with and encourages teams to adopt the following principles:

  • Shared Ownership: Reviews should be the responsibility of the team. This will accelerate everyone's workflow. If the team owns the review, a review isn't limited by one person's schedule.
  • Write Small PRs: Small, focused units of change have many benefits and is considered best practice.
  • Time to First Review is Key: PRs that are stuck waiting for reviews aren't great. It's frustrating for the author, a drag on throughput, and if it happens too much, will undermine other best practices like writing small PRs.
  • PRs are Prioritized: Code ready to review should (in general) be prioritized over code still being written. Code in review encapsulates a lot of business effort (customer feedback, product planning, architecture design, programming, etc), but its value hasn't been realized yet even though the work is mostly complete. Generally, it's in the team's best interest to prioritize finishing and delivering the code in review over code in earlier stages.
An illustration depicting a collaborative team reviewing code efficiently using PullPro.

How It Works

  1. Mark PR as Ready for Review: In GitHub, the author marks the PR as ready for review.
  2. Automatic Posting to Slack: The app posts the PR to the appropriate Slack channel based on routing settings.
  3. Team Member Claims the PR: Claim right in slack. Slack reactions automatically added to the PR communicates to the team when the PR is claimed, who claimed it and if others have looked at it.
  4. Review Process: The reviewer conducts the review and submits feedback on GitHub.
  5. Reminders: A variety of automated reminders and messages ensure that the review process continues to move forward.
  6. Metrics: Key review metrics are collected and transparently reported on a regular basis to help teams understand their review process and where they can improve.

Next Steps

Ready to enhance your team's code review process?

  • Proceed to Installation & Setup to install the app and link your Slack workspace with GitHub.
  • Explore Using the App to learn about posting PRs, claiming reviews, and managing PRs within Slack.

Get Involved

We are committed to continuous improvement and value your feedback.

  • Questions or Issues? Visit Community & Support for assistance.
  • Stay Updated: Follow updates to learn about new features and improvements.

Thank you for choosing PullPro to streamline your code review process!