This is an automated email from the ASF dual-hosted git repository.
lucasbru pushed a commit to branch markdown
in repository https://gitbox.apache.org/repos/asf/kafka-site.git
The following commit(s) were added to refs/heads/markdown by this push:
new 94427bd723 Improve wording of KAFKA-20254 migration warning (#826)
94427bd723 is described below
commit 94427bd7235c24fb0a8731311e17cc6a7400c27b
Author: Lucas Brutschy <[email protected]>
AuthorDate: Tue Mar 10 10:20:49 2026 +0100
Improve wording of KAFKA-20254 migration warning (#826)
Clarify that the warning applies to migrating a classic group to the new
protocol, and that users should wait for a future release rather than implying
one already exists.
---
content/en/42/getting-started/upgrade.md | 2 +-
content/en/42/streams/developer-guide/streams-rebalance-protocol.md | 2 +-
content/en/42/streams/upgrade-guide.md | 2 +-
3 files changed, 3 insertions(+), 3 deletions(-)
diff --git a/content/en/42/getting-started/upgrade.md
b/content/en/42/getting-started/upgrade.md
index 83ab8e0a31..4b353c2419 100644
--- a/content/en/42/getting-started/upgrade.md
+++ b/content/en/42/getting-started/upgrade.md
@@ -34,7 +34,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 [...]
- * 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}/streams/develo [...]
+ * 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}/streams/develo [...]
* The `org.apache.kafka.common.header.internals.RecordHeader` class has been
updated to be read thread-safe. See
[KIP-1205](https://cwiki.apache.org/confluence/x/nYmhFg) for details. In other
words, each individual `Header` object within a `ConsumerRecord`'s `headers`
can now be safely read from multiple threads concurrently.
* The `org.apache.kafka.disallowed.login.modules` config was deprecated.
Please use the `org.apache.kafka.allowed.login.modules` instead.
* The `remote.log.manager.thread.pool.size` config was deprecated. Please
use the `remote.log.manager.follower.thread.pool.size` instead.
diff --git
a/content/en/42/streams/developer-guide/streams-rebalance-protocol.md
b/content/en/42/streams/developer-guide/streams-rebalance-protocol.md
index 33800ebc17..df019a1086 100644
--- a/content/en/42/streams/developer-guide/streams-rebalance-protocol.md
+++ b/content/en/42/streams/developer-guide/streams-rebalance-protocol.md
@@ -254,4 +254,4 @@ Similarly, you can convert a streams group back to a
classic group by following
**Warning:** Online migration (migrating while the application is running) is
not available in this version. Plan for a maintenance window when migrating
between protocols.
-**Warning:** Due to a critical broker-side 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 their brokers to a later release that includes the fix.
+**Warning:** Due to a critical broker-side 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 a
classic group to the new protocol should wait for a future release that
includes the fix.
diff --git a/content/en/42/streams/upgrade-guide.md
b/content/en/42/streams/upgrade-guide.md
index a201d2a108..8e5145d6f8 100644
--- a/content/en/42/streams/upgrade-guide.md
+++ b/content/en/42/streams/upgrade-guide.md
@@ -72,7 +72,7 @@ This release marks the General Availability for the core
functionality detailed
For more information about the feature set, design, usage and migration,
please refer to the [developer
guide](/{version}/streams/developer-guide/streams-rebalance-protocol).
-**Note:** Due to a critical broker-side 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 their brokers to a later release that includes the fix.
+**Note:** Due to a critical broker-side 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 a
classic group to the new protocol should wait for a future release that
includes the fix.
### Other changes
