mingdaoy commented on code in PR #19119: URL: https://github.com/apache/kafka/pull/19119#discussion_r1991109201
########## docs/upgrade.html: ########## @@ -29,7 +31,26 @@ <h5><a id="upgrade_410_notable" href="#upgrade_410_notable">Notable changes in 4 </ul> </li> </ul> -<h4><a id="upgrade_4_0_0" href="#upgrade_4_0_0">Upgrading to 4.0.0 from any version 3.3.x through 3.9.x</a></h4> + +<h4><a id="upgrade_4_0_0" href="#upgrade_4_0_0">Upgrading to 4.0.0</a></h4> + +<h5><a id="upgrade_clients_4_0_0" href="#upgrade_clients_4_0_0">Upgrading Clients to 4.0.0</a></h5> + +<p><b>For a rolling upgrade:</b></p> + +<ol> + <li>Upgrade the clients one at a time: shut down the client, update the code, and restart it.</li> + <li>For the Kafka client upgrade path, note that many deprecated APIs were removed in Kafka 4.0. Additionally, upgrading directly to 4.x from certain versions is not feasible. + For more information, please refer to <a href="https://cwiki.apache.org/confluence/x/y4kgF">KIP-1124</a>.</li> Review Comment: I changed it to the following, > For the Kafka client upgrade path, note that many deprecated APIs were removed in Kafka 4.0. Additionally, upgrading directly **from certain versions, such as 2.0 clients (or older)**, to 4.x is not feasible. **2.1 is the oldest supported version compatible with 4.0** -- 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