diff --git a/Documentation/access-control.txt b/Documentation/access-control.txt
index 2db6a198ff..b1f01fda2d 100644
--- a/Documentation/access-control.txt
+++ b/Documentation/access-control.txt
@@ -833,8 +833,6 @@ much of the server administration burden out to more users.
 Below you find a list of capabilities available:
 
 
-* Flush Caches
-
 * Kill Task
 
 * Priority
@@ -887,6 +885,18 @@ either link:cmd-create-project.html[create new git projects via ssh]
 or via the web UI.
 
 
+[[capability_flushCaches]]
+Flush Caches
+~~~~~~~~~~~~
+
+Allow the flushing of Gerrits caches.  This capability allows the granted
+group to link:cmd-flush-caches.html[flush some or all Gerrit caches via ssh].
+
+[NOTE]
+This capability doesn't imply permissions to the show-caches command.  For that
+you need the <<capability_viewCaches,view caches capability>>.
+
+
 [[capability_queryLimit]]
 Query Limit
 ~~~~~~~~~~~
diff --git a/Documentation/cmd-flush-caches.txt b/Documentation/cmd-flush-caches.txt
index f8882c8115..bc6fac54ef 100644
--- a/Documentation/cmd-flush-caches.txt
+++ b/Documentation/cmd-flush-caches.txt
@@ -26,7 +26,8 @@ If no options are supplied, defaults to `--all`.
 ACCESS
 ------
 Caller must be a member of the privileged 'Administrators' group,
-or have granted the 'Flush Caches' global capability.
+or in a group that have been granted
+link:access-control.html#capability_flushCaches[the 'Flush Caches' global capability].
 
 SCRIPTING
 ---------