This is an automated email from the ASF dual-hosted git repository.
lucasbru pushed a commit to branch 4.2
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/4.2 by this push:
new 6f15d58ae6f MINOR: Fix broken documentation links for Streams
Rebalance Protocol (#21685)
6f15d58ae6f is described below
commit 6f15d58ae6f5e3cb70e55bbc917b67eea520993c
Author: Lucas Brutschy <[email protected]>
AuthorDate: Tue Mar 10 15:12:17 2026 +0100
MINOR: Fix broken documentation links for Streams Rebalance Protocol
(#21685)
Fix internal documentation links that were using the old path format
(`/documentation/streams/...`) and `.html` extensions, which no longer
resolve correctly in the new docs site structure. Also reorder the
KAFKA-20254 migration warning note in the Streams upgrade guide to
appear after the GA announcement paragraph for better readability.
Reviewers: Matthias J. Sax <[email protected]>
---
docs/getting-started/upgrade.md | 2 +-
docs/streams/developer-guide/app-reset-tool.md | 2 +-
docs/streams/developer-guide/streams-rebalance-protocol.md | 2 +-
docs/streams/upgrade-guide.md | 6 +++---
4 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/docs/getting-started/upgrade.md b/docs/getting-started/upgrade.md
index e9a088018ad..310722192fa 100644
--- a/docs/getting-started/upgrade.md
+++ b/docs/getting-started/upgrade.md
@@ -36,7 +36,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}/documentation/ [...]
+ * 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/docs/streams/developer-guide/app-reset-tool.md
b/docs/streams/developer-guide/app-reset-tool.md
index 9a466fc14e5..38c4eee681f 100644
--- a/docs/streams/developer-guide/app-reset-tool.md
+++ b/docs/streams/developer-guide/app-reset-tool.md
@@ -56,7 +56,7 @@ Prerequisites
# Step 1: Run the application reset tool
-If you are using **streams rebalance protocol** (available since AK 4.2), use
the [Streams groups CLI](kafka-streams-group-sh#reset-offsets).
+If you are using **streams rebalance protocol** (available since AK 4.2), use
the [Streams groups
CLI](/{version}/streams/developer-guide/kafka-streams-group-sh#reset-offsets).
If you are using **classic rebalance protocol** , run the classic application
reset tool as described below.
diff --git a/docs/streams/developer-guide/streams-rebalance-protocol.md
b/docs/streams/developer-guide/streams-rebalance-protocol.md
index 33800ebc17d..dc84182bf10 100644
--- a/docs/streams/developer-guide/streams-rebalance-protocol.md
+++ b/docs/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. The fix will be targeted for a
future release.
diff --git a/docs/streams/upgrade-guide.md b/docs/streams/upgrade-guide.md
index d701cd33fd4..e148f242954 100644
--- a/docs/streams/upgrade-guide.md
+++ b/docs/streams/upgrade-guide.md
@@ -65,14 +65,14 @@ Since 2.6.0 release, Kafka Streams depends on a RocksDB
version that requires Ma
## Streams API changes in 4.2.0
-**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.
-
### General Availability for a core feature set of the Streams Rebalance
Protocol (KIP-1071)
The Streams Rebalance Protocol is a broker-driven rebalancing system designed
specifically for Kafka Streams applications.
This release marks the General Availability for the core functionality
detailed in
[KIP-1071](https://cwiki.apache.org/confluence/display/KAFKA/KIP-1071%3A+Streams+Rebalance+Protocol).
For more information about the feature set, design, usage and migration,
-please refer to the [developer
guide](/{version}/documentation/streams/developer-guide/streams-rebalance-protocol.html).
+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. The fix will be targeted for a
future release.
### Other changes
