Using the App

This section covers how to use PullPro to coordinate pull requests reviews directly from Slack. Learn how to post, claim, and manage PRs.

Posting Pull Requests

There are two ways to post a pull request in Slack:

(Recommended) Automatically, when a PR is marked as ready for review in GitHub.
Manually, by using the /pr [description] command in the desired Slack channel.

Automatically

In order for PRs to be posted automatically ensure you have installed the GitHub app and configured your routing settings.

Once a PR is marked as ready for review in GitHub, it is automatically posted in the desired Slack channel based on your team's routing settings.
The PR message includes key details, such as the PR title, author, and additional metadata.
Each PR message will have options for team members to claim or simply view it.

A screenshot of a PR being posted in Slack with options to claim or view the PR.

Claiming & Reviewing PRs

Click "Claim review" (✋raised hand emoji) to assign yourself as the reviewer for a PR. This helps keep the team informed of who is responsible for the review.
The app will react, on your behalf, to the Slack message to indicate that the PR has been claimed by you.
After claiming, proceed to review the PR on GitHub and provide your feedback.
Approvals on GitHub will also get added as a reaction (✅ white check mark) to the PR message in Slack.

Viewing a PR

Click "Take a look" (👀 eyes emoji) to open the PR on GitHub without claiming responsibility for the review.
The app will react, on your behalf, to the Slack message to indicate that you have viewed the PR. This provides transparency to the author and the team on who has seen the PR (even if you don't leave comments or approve it).

A screenshot of a PR being posted in Slack with options to claim or view the PR.

Managing PRs in Slack

In addition to posting and claiming PRs, PullPro also helps your team stay accountable to your PR review process directly within Slack.

Notifications for Claimed PRs

If a PR has been claimed but not reviewed within a set timeframe, the app will send a reminder to the person who claimed it. This helps prevent PRs from lingering too long without attention.

Reminders for Unclaimed PRs

If no one claims a PR within a configurable amount of time, the app will send a reminder to the team in the Slack channel where the PR was posted.
In addition to the public reminder, PullPro will also send a direct message to a chosen user, based on the user's slack status & participation in reviews.
These reminders ensure that PRs are not forgotten and help keep the review process moving smoothly.

Managing PRs in Different Channels

Depending on your team’s setup, PRs can be routed to different channels based on the repository, author, or other criteria defined in the routing settings.
This allows teams to manage PRs in the most relevant Slack channels, avoiding clutter and improving organization.
You can also move PRs between channels if needed using the app’s advanced features.

Next Steps

Proceed to Reminders & Notifications to learn more about how reminders work and how they can be customized for your team.
Visit Metrics & Reports to understand how your team's PR review process is performing.
Explore Advanced Features to learn about additional functionality, such as moving PRs between channels.