Pull request turns

Each pull request has an explicit "turns" field, which is used to identify and communicate exactly whose turn it is to take the next action on the pull request.

Alt text

As events are triggered in PullApprove and in GitHub, the turns field is automatically updated to reflect the current state of the pull request.

For example, when review requests are sent out, the turn is set to the reviewers. Likewise when reviews are submitted, the turn is set back to the author.

PullApprove uses turns to drive the "My work" dashboard, where you can clearly see which PRs are waiting on you and which are waiting on someone else. If you need to, you can manually change the turn to another user to indicate that it's not held up on you.