Skip to content
← Trylle Journal
Code reviewProduct

Designing a review queue that respects attention

Reviewers do not need another inbox. They need to know which pull request is blocked on them right now, and why it landed there.

Alan · Co-Founder1 min read

A notification feed tells you that something happened. A queue tells you what to do next. Those are different products, and most review tools ship the first one and call it the second.

Blocked on you, and only that

The Trylle review queue contains pull requests where your review is the remaining blocker. Not everything you are subscribed to, not everything your team touched. When you clear the queue, you are actually done.

Explain the ordering

Each entry says why it is there: requested directly, code owner for a changed path, or re-requested after changes. Ordering that you can explain is ordering people will trust enough to work top to bottom.