Sometimes it is not the right time for a pull request to be reviewed or merged, even though every aspect is green (code, build, review etc.).

When that happens it is common practice to add a [HOLD] or [WIP] keyword in the title of the PR to quickly let people know that the PR is not ready to be actioned yet. Labels can also be used of course - after all they were designed for that.

So the question is: How to reflect this informal prioritization on Keypup? Let us show you how to do it.

First we'll de-prioritize PRs and issues which are on hold so as to ensure our priority inbox is not polluted by these items. Then we'll add a report tab on our priority inbox showing the list of items currently on hold so we can still monitor them.

> De-prioritize items which are on hold

The first step is to ensure that items put on hold do not appear in our priority inbox.

Let's head to User Profile > Prioritization Rules and create a new rule that de-prioritizes issues and PRs which are on hold:

The rule is composed of AND/OR combinators selecting open items which match one of the following:

  • Start with the [HOLD] or [WIP] keyword in their title

  • Have the on-hold label

Any item matching this rule will be flagged as UNPRIORITIZED.

With this rule in place you can be sure that items on hold will never be prioritized in your inbox.

> Track the list of pull requests and issues on hold

Now we're going to create a custom report to track items which are currently on hold.

Let's head to the Data Explorer and use the same query as what we used for the prioritization rule:

Protip: if you have a lot of items on hold - including stale PRs - you may as well add some date conditions such as updated > 2 months ago. This kind of time-based filter can help refine monitoring reports to be more aligned with the current development priorities.

Click on Save as new then pin this report to your priority inbox:

Voila! You can now track these items directly from your inbox!

There is a lot you can do to further improve your inbox just by using title keywords, labels and time filters. Feel free to get creative and create prioritization rules and reports that suit your needs.

Need any help doing so? Feel free to contact us via chat.

Did this answer your question?