From 492c89e4e8148bdc51eaf256d5bc69bcc9d79d2c Mon Sep 17 00:00:00 2001
From: Edoardo Comar <ecomar@uk.ibm.com>
Date: Fri, 25 Apr 2025 14:23:08 +0100
Subject: [PATCH] KAFKA-19026: add note in ZK to KRaft migration

Add a brief note pointing to the issue in the migration guide
---
 docs/ops.html | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/ops.html b/docs/ops.html
index e79a8a9581dce..94dc19b4edff4 100644
--- a/docs/ops.html
+++ b/docs/ops.html
@@ -4010,6 +4010,11 @@ <h3>Limitations</h3>
     </li>
     <li><a href="#kraft_missing">As noted above</a>, some features are not fully implemented in KRaft mode. If you are
       using one of those features, you will not be able to migrate to KRaft yet.</li>
+    <li>
+      There is a known inconsistency between ZK and KRaft modes in the arguments passed to an <code>AlterConfigPolicy</code>,
+      when an <code>OpType.SUBTRACT</code> is processed.
+      For further details refer to <a href="https://issues.apache.org/jira/browse/KAFKA-19026">KAFKA-19026</a>.
+    </li>
   </ul>
 
   <h3>Preparing for migration</h3>