From d460efb9c981634f6d81d292aee8838713761b87 Mon Sep 17 00:00:00 2001
From: TengYao Chi <kitingiao@gmail.com>
Date: Mon, 3 Mar 2025 03:00:41 +0800
Subject: [PATCH] KAFKA-18908 Document that the size of appended value can't be
 larger than Short.MAX_VALUE (#19067)

JIRA: KAFKA-18908
`ZooKeeper` mode allows large configuration values to be created through
an append operation. `KRaft` mode restricts configuration values to a
maximum size of `Short.MAX_VALUE`.
We should document this behavioral change.

Reviewers: Ken Huang <s7133700@gmail.com>, Chia-Ping Tsai <chia7712@gmail.com>
---
 docs/zk2kraft.html | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/zk2kraft.html b/docs/zk2kraft.html
index f699d6f9148..a5fc920c827 100644
--- a/docs/zk2kraft.html
+++ b/docs/zk2kraft.html
@@ -232,6 +232,16 @@
             </ul>
         </li>
     </ul>
+    <h2 class="anchor-heading">Behavioral Change Reference</h2>
+    <p>
+        This document catalogs the functional and operational differences between ZooKeeper mode and KRaft mode.
+    </p>
+    <ul>
+        <li>
+            <strong>Configuration Value Size Limitation</strong>: KRaft mode restricts configuration values to a maximum size of <code>Short.MAX_VALUE</code>,
+            which prevents using the append operation to create larger configuration values.
+        </li>
+    </ul>
 </div>
 <!--#include virtual="../includes/_footer.htm" -->
 </div>
\ No newline at end of file