Gerrit Code Review - Attention Set

To help with the back and forth, Gerrit applies some basic automated rules for changing the attention set:

!IMPORTANT! These rules are not meant to be super smart and to always do the right thing, e.g. if the change owner sends a reply, then they are often expected to individually select whose turn it is.

Note that just uploading a new patchset is not a relevant event for the attention set to change.

There are three ways to interact with the attention set: The attention icon, the hovercard of owner and reviewer chips and the "Reply" dialog.

The attention icon can be used to quickly remove yourself (or someone else) from the attention set. Just click the icon, and it will disappear:

The hovercard (on both the Dashboard and Change page) contains information about whether, why and when a user was added to the attention set. It also contains an action for adding/removing the user to/from the attention set.

The reply dialog contains a section for controlling to whom the turn should be passed.

If you click "MODIFY", then the section will expand and you can select and de-select users by clicking on their chips. Whatever you select here will be the new state of the attention set for this change. As a change owner make sure to remove reviewers that you don’t expect to take action.

The attention set is meant for human reviews only. Triggering bots and reacting to their results is a different workflow and not in scope of the attenion set. Thus members of the "Service Users" group will never be added to the attention set. And replies by such users will only add the change owner (and uploader) to the attention set, if it comes along with a negative vote.

The default dashboard contains a new section at the top called "Your Turn". It lists all changes where the logged-in user is in the attention set. When you are a reviewer, the change is highlighted and is shown at the top of the section. The "Waiting" column indicates how long the owner has already been waiting for you to act.

As an active developer, one of your daily goals will be to iterate over this list and clear it.

Note that you can also navigate to other users' dashboards to check their "Your Turn" section.

Every email begins with Attention is currently required from: …​, so you can identify at a glance whether you are expected to act.

You can even change your email notification preferences in the user settings to only receive emails when you are in the attention set of a change:

If you prefer setting up customized filters in your mail client, then you can make use of the Gerrit-Attention: footer lines that are added for every user in the attention set, e.g.

While the "Assignee" feature can still be used together with the attention set, we do not recommend doing so. Using both features is likely confusing. The distinct feature of the "Assignee" compared to the attention set is that only one user can be the assignee at the same time. So the assignee can be used to single out one person or escalate, if there are multiple reviewers. Since every reviewer in the attention set is expected to take action, singling out is not likely to be important and also still achievable with the attention set. Otherwise "Assignee" and "Attention Set" are very much overlapping, so we recommend to only use one of them.

If you don’t expect action from reviewers, then consider adding them to CC instead.

The "Assignee" feature can be turned on/off with the enableAssignee config option.

Before the attention set feature, changes were bolded in the dashboard when something happened and you could explicitly "mark a change reviewed" on the change page. This former way of keeping track of what you should look at has been replaced by the attention set.

The Attention Set will be part of the upcoming 3.3 release (due late 2020). It is enabled by default, but you can disable it by setting enableAttentionSet to false.

If you are a host/project owner, please make sure all bots that run against your host/project are part of the "Service Users" group.

If you are a bot owner, please make sure your bot is part of the "Service Users" group on all hosts it runs on.

To add users to the "Service Users" group, first ensure that the group exists on your host. If it doesn’t, create it. The name must exactly be "Service Users".

To create a group, use the Gerrit UI; BROWSE → Groups → CREATE NEW.

Then, add the bots as members in this group. Alternatively, add an existing group that has multiple bots as a subgroup of "Service Users".

To add members or subgroups, use the Gerrit UI; BROWSE → Groups → search for "Service Users" → Members.

Part of Gerrit Code Review