Add instructions to add bots to the "Service Users" group

Attention set behaves differently for users in that group, and
users that are not in the group. It's best to make sure that all
bots are in the Service Users group; such that they do not affect
the attention set.

Change-Id: I91194fbb8cbe7fafd1d74d751e5c764b258b5983

1 files changed, 19 insertions, 0 deletions

diff --git a/Documentation/user-attention-set.txt b/Documentation/user-attention-set.txt
index 217c353759..7e219d4c92 100644
--- a/Documentation/user-attention-set.txt
+++ b/Documentation/user-attention-set.txt
@@ -161,6 +161,25 @@ We are testing it on `googlesource.com` right now. If you build your Gerrit from
 master, you can enable it using
 link:config-gerrit.html#change.enableAttentionSet[enableAttentionSet].
 
+=== Important note for all host owners, project owners, and bot owners
+
+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.
+
 GERRIT
 ------
 Part of link:index.html[Gerrit Code Review]