My turn
The pull requests where you owe the next action, and nothing else. A card goes when you act or when you dismiss it.
On this page
My turn is the first tab on Pending. It lists the pull requests where a person is waiting on you: a review you were asked for, a reply to your comment, a mention, new code to re-read, or your own pull request that needs you. A card appears when that is true and goes when it stops being true. Nothing about it is a to-do list you have to keep clean.
#The groups
The tab has fixed groups, always in this order, with the longest wait first in each:
| Group | A card appears when | It goes when |
|---|---|---|
| Waiting on you | Someone asks you to review a pull request. | You submit a review. |
| Someone @-mentions you on an open pull request. | You review, comment or push on it. | |
| Someone replies in a review thread you started, or the code under it changes. | You reply, or the thread is resolved. | |
| Someone replies after your comment in a thread someone else started. | You reply, or the thread is resolved. | |
| Someone comments on a pull request after your last comment or review there. | You review, comment or push on it. | |
| Re-review | Someone pushes to a pull request after your last review or comment. | You review, comment or push. |
| Your PRs | The latest build on your open pull request failed. | The build passes. |
| Your pull request conflicts with its base. | The conflict is resolved. | |
| Your pull request has an approval and no "changes requested". | It is merged or closed. | |
| GitHub will merge your pull request, or wants the branch updated. | It merges, or stops being ready. | |
| A review comment on your pull request has had no reply for a day. | Someone replies or pushes to its file. | |
| New PRs | Someone else opened a pull request you have not touched, since the repository was added. Only with Also show new PRs nobody asked you about on. | You review, comment or push. |
A card whose wait is older than 14 days moves to a closed Older group at the end. It still counts.
One card per pull request
A pull request that holds two jobs for you shows one card: the first in the order of the table above, then the oldest. When that job is done, the next one shows. Your own pull request's failing build, conflict, readiness to land and unanswered threads are listed here instead of in their usual tab, so each is listed once.
#The card's buttons
Each card leads with the one action its job needs:
- Start review opens the pull request on its Changes tab.
- Reply opens the thread with a reply box. A thread card also has a resolve button.
- Answer and Read it open the comment that needs you.
- See the commits opens the pull request's Activity tab at the new commits.
- On Your PRs, a ready pull request carries the merge buttons (see Ready to land) and a conflict carries Resolve conflicts.
#What does not put a card here
- Bots. No bot action returns the ball to you, not even a push. Limn's own posts do not either.
- Side comments. A comment that is not an answer to you, such as a comment in a thread you never wrote in, does not bring you back.
- Drafts. A draft pull request never puts a card here.
- A red default branch. It is not one person's task. It shows in Needs fixing and on the default branch strip.
- Opening a pull request. Reading it is not an action. Reviewing, commenting or pushing is.
If you approve a pull request after a reply in a thread, that counts as your answer to the reply.
#Your turn and In your repos
A card says Your turn when it involves you directly: you wrote it, you were asked, you were mentioned or you took part. In your repos marks a new pull request in a repository you maintain. Other cards carry the plain label for what they are, such as Review or reply.
#Only yours
Only yours narrows My turn to the cards that involve you, and Not tied to you shows the rest. Each pill shows its own count.
#Dismiss a card
Every card can be dismissed, for an item you cannot act on now, or ever. A dismissal sets the pull request down until something new happens on it. Something new comes back as itself: a new reply comes back as a reply.
- Select the card and press e, or choose Dismiss in the panel, or the ✕ on the row.
- Press z or choose Undo to take it back at once.
- To bring one back later, open Dismissed at the foot of the tab and choose Bring back.
#Mute a repository
To keep a repository out of My turn altogether, mute it in Settings → Pending. Muted repositories never appear in My turn and never notify you. The other tabs still show them: your own failing build in a muted repository goes back to Needs fixing. The mute is per workspace.
#Show new pull requests
My turn has one setting: Also show new PRs nobody asked you about, in Settings → Pending (the Customise link on the tab goes there). With it on, the New PRs group lists other people's pull requests you have not touched. It is off by default.