mjsax commented on code in PR #21638:
URL: https://github.com/apache/kafka/pull/21638#discussion_r2892438340


##########
docs/getting-started/upgrade.md:
##########
@@ -49,7 +49,7 @@ type: docs
 
   * The `--max-partition-memory-bytes` option in `kafka-console-producer` is 
deprecated and will be removed in Kafka 5.0. Please use `--batch-size` instead. 
   * Queues for Kafka ([KIP-932](https://cwiki.apache.org/confluence/x/4hA0Dw)) 
is production-ready in Apache Kafka 4.2. This feature introduces a new kind of 
group called share groups, as an alternative to consumer groups. Consumers in a 
share group cooperatively consume records from topics, without assigning each 
partition to just one consumer. Share groups also introduce per-record 
acknowledgement and counting of delivery attempts. Use share groups in cases 
where records are processed one at a time, rather than as part of an ordered 
stream. 
-  * The Streams Rebalance Protocol 
([KIP-1071](https://cwiki.apache.org/confluence/display/KAFKA/KIP-1071%3A+Streams+Rebalance+Protocol))
 is now production-ready for its core feature set. This broker-driven 
rebalancing system designed specifically for Kafka Streams applications 
provides faster, more stable rebalances and better observability. For more 
information about the supported feature set, usage, and migration, please refer 
to the [Streams developer 
guide](/{version}/documentation/streams/developer-guide/streams-rebalance-protocol.html).
+  * The Streams Rebalance Protocol 
([KIP-1071](https://cwiki.apache.org/confluence/display/KAFKA/KIP-1071%3A+Streams+Rebalance+Protocol))
 is now production-ready for its core feature set. This broker-driven 
rebalancing system designed specifically for Kafka Streams applications 
provides faster, more stable rebalances and better observability. For more 
information about the supported feature set, usage, and migration, please refer 
to the [Streams developer 
guide](/{version}/documentation/streams/developer-guide/streams-rebalance-protocol.html).
 Due to a critical bug in the offline migration code 
([KAFKA-20254](https://issues.apache.org/jira/browse/KAFKA-20254)), we 
recommend against doing migrations from classic to streams groups in 4.2.0. 
Newly created streams groups are not impacted. Users planning to migrate should 
upgrade to a later release that includes the fix.

Review Comment:
   I think we should clarify that's it's a broker side bug, and users need to 
upgrade their brokers, not KS clients to get the fix.



-- 
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: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to