From 4187e635219106678383adba5a27d60af5dbd476 Mon Sep 17 00:00:00 2001
From: Gregory Newman-Smith <109068393+gregns1@users.noreply.github.com>
Date: Fri, 3 Jan 2025 15:14:01 +0000
Subject: [PATCH] CBG-4403: update rev cache size api docs for size stat
 (#7257)

---
 docs/api/components/schemas.yaml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/api/components/schemas.yaml b/docs/api/components/schemas.yaml
index a0cdd559b0..1ffbd98468 100644
--- 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: