Suggest Reviewers: Document when accounts are visible
The reviewer suggestion only suggests accounts that are visible to the
calling user. Whether an account is visible to the calling user depends
on the 'accounts.visibility' setting of the server. Mention this and
explain how to check which account visibility is configured for the
server.
Release-Notes: skip
Bug: Google b/313411537
Change-Id: Ib3289b22a6270f3480656ec6ce504d4f9404f196
Signed-off-by: Edwin Kempin <ekempin@google.com>
diff --git a/Documentation/rest-api-changes.txt b/Documentation/rest-api-changes.txt
index ac91c9e..82f1f6e 100644
--- a/Documentation/rest-api-changes.txt
+++ b/Documentation/rest-api-changes.txt
@@ -3675,10 +3675,22 @@
This REST endpoint only suggests accounts that
* are active
+
* can see the change
-* are visible to the calling user
+
+* are visible to the calling user:
++
+Whether an account is visible to the calling user depends on the
+link:config-gerrit.html#accounts.visibility[accounts.visibility] setting of the
+server. Which account visibility is configured can be checked by opening
+`https://<HOST>/config/server/info?pp=1` in a browser (see field `accounts` >
+link:rest-api-config.html#accounts-config-info[visibility] in the returned
+JSON).
+
* are not already reviewer on the change
+
* don't own the change
+
* are not service users (unless
link:config.html#suggest.skipServiceUsers[skipServiceUsers] is set to `false`)
