fvaleri commented on code in PR #14484:
URL: https://github.com/apache/kafka/pull/14484#discussion_r1346951876


##########
docs/upgrade.html:
##########
@@ -145,7 +145,7 @@ <h5><a id="upgrade_350_kraft" 
href="#upgrade_350_kraft">Upgrading KRaft-based cl
             </code>
         </li>
         <li>Note that the cluster metadata version cannot be downgraded to a 
pre-production 3.0.x, 3.1.x, or 3.2.x version once it has been upgraded.
-            However, it is possible to downgrade to production versions such 
as 3.3-IV0, 3.3-IV1, etc.</li>
+            However, it is possible to downgrade to a backwards compatible 
metadata version. The active Controller will block any incompatible downgrade 
attempt.</li>

Review Comment:
   I thought about that, but doesn't seem a great user experience. That said, I 
don't see a better way, unless we want to create a new tool command to verify 
if downgrade is possible between any two versions, and document that.



##########
docs/upgrade.html:
##########
@@ -145,7 +145,7 @@ <h5><a id="upgrade_350_kraft" 
href="#upgrade_350_kraft">Upgrading KRaft-based cl
             </code>
         </li>
         <li>Note that the cluster metadata version cannot be downgraded to a 
pre-production 3.0.x, 3.1.x, or 3.2.x version once it has been upgraded.
-            However, it is possible to downgrade to production versions such 
as 3.3-IV0, 3.3-IV1, etc.</li>
+            However, it is possible to downgrade to a backwards compatible 
metadata version. The active Controller will block any incompatible downgrade 
attempt.</li>

Review Comment:
   I thought about that, but doesn't seem a great user experience.
   
   That said, I don't see a better way, unless we want to create a new tool 
command to verify if downgrade is possible between any two versions, and 
document that.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to