diff --git a/docs/streams/upgrade-guide.html b/docs/streams/upgrade-guide.html
index fbafebe967e..4eb21b8211b 100644
--- a/docs/streams/upgrade-guide.html
+++ b/docs/streams/upgrade-guide.html
@@ -97,6 +97,8 @@
         We removed the following deprecated APIs:
     </p>
     <ul>
+        <li> <code>StreamsBuilder#addGlobalStore</code> (one overload): deprecated in Kafka 1.1.0 (<a href="https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=74689212">KIP-233</a>).</li>
+        <li> <code>ProcessorContext#forward</code> (some overloads): deprecated in Kafka 2.0.0 (<a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-251%3A+Allow+timestamp+manipulation+in+Processor+API">KIP-251</a>).</li>
         <li> <code>WindowBytesStoreSupplier#segments</code>: deprecated in Kafka 2.1.0 (<a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-319%3A+Replace+segments+with+segmentInterval+in+WindowBytesStoreSupplier">KIP-319</a>).</li>
     </ul>
 
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 30550d755b6..7438192b956 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -25,6 +25,8 @@
     <li>A number of implementation dependency jars are <a href="https://github.com/apache/kafka/pull/10203">now available in the runtime classpath
         instead of compile and runtime classpaths</a>. Compilation errors after the upgrade can be fixed by adding the missing dependency jar(s) explicitly
         or updating the application not to use internal classes.</li>
+    <li>The Streams API removed all deprecated APIs that were deprecated in version 2.5.0 or earlier.
+        For a complete list of removed APIs compare the detailed Kafka Streams upgrade notes.</li>
 </ul>
 
 <h5><a id="upgrade_280_notable" href="#upgrade_280_notable">Notable changes in 2.8.0</a></h5>