From 1d4b22bc3e6477eebaf07e191d59780872eec38a Mon Sep 17 00:00:00 2001
From: lucliu1108 <lucliu@confluent.io>
Date: Fri, 25 Jul 2025 12:22:09 -0500
Subject: [PATCH] MINOR: Improve Kafka Streams Protocol Upgrade Doc (#20241)

As a follow-up minor addition to PR for
[KSTREAMS-7735](https://confluentinc.atlassian.net/browse/KSTREAMS-7735
) (https://github.com/apache/kafka/pull/20029) , add the instructions
for upgrading `streams.version` parameter for KIP-1071 EA.

Reviewers: Andrew Schofield <aschofield@confluent.io>
---
 docs/streams/upgrade-guide.html | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/streams/upgrade-guide.html b/docs/streams/upgrade-guide.html
index 8816f3b933a..58938c9b347 100644
--- a/docs/streams/upgrade-guide.html
+++ b/docs/streams/upgrade-guide.html
@@ -213,6 +213,11 @@
         Set <code>unstable.feature.versions.enable=true</code> for controllers and brokers, and
         set <code>unstable.api.versions.enable=true</code> on the brokers as well. In your Kafka Streams application
         configuration, set <code>group.protocol=streams</code>.
+        Upgrade the `streams.version` feature to 1. To do this, run
+	<code>kafka-features.sh --bootstrap-server localhost:9092 upgrade --feature streams.version=1</code>
+	to upgrade, or use Admin#updateFeatures API to update `streams.version`. After the feature is updated, check
+	<code>kafka-features.sh --bootstrap-server localhost:9092 describe</code>
+	and `streams.version` should now have FinalizedVersionLevel 1.
     </p>
 
     <p>