CBG-4403: update rev cache size api docs for size stat (#7257)

couchbase · Jan 3, 2025 · 94e223e · 94e223e
1 parent 88edb9a
commit 94e223e
Showing 1 changed file with 4 additions and 1 deletion.
diff --git a/docs/api/components/schemas.yaml b/docs/api/components/schemas.yaml
@@ -1301,7 +1301,10 @@ Database:
           type: object
           properties:
             size:
-              description: The maximum number of revisions that can be stored in the revision cache.
+              description: |-
+                The maximum number of revisions that can be stored in the revision cache.
+                Note when running with greater than 1 shard count we add 10% capacity overall to avoid early eviction when some shards fill up before others, so
+                you may find that the capacity stat (revision_cache_num_items) will climb to the defined rev cache size + 10%.
               type: string
               default: 5000
             max_memory_count_mb: