diff --git a/src/main/resources/Documentation/config.md b/src/main/resources/Documentation/config.md
index a76545f..02806a1 100644
--- a/src/main/resources/Documentation/config.md
+++ b/src/main/resources/Documentation/config.md
@@ -9,7 +9,9 @@
 ## Configuration parameters
 
 ```cache.synchronize```
-:   Whether to synchronize cache evictions.
+:   Whether to run cache evictions synchronously. It requires disabling the
+    background cache evictions notifications in `gerrit.config` by setting
+    `cache.threads = 0`.
     Defaults to true.
 
 ```cache.threadPoolSize```