diff --git a/docs/streams.html b/docs/streams.html
index 2b4c4414f6f..fe0e84ee3b7 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -813,6 +813,13 @@ $ java -cp path-to-app-fatjar.jar com.example.MyStreamsApp
         See <a href="#streams_api_changes_0101">below</a> a complete list of 0.10.1 API changes that allow you to advance your application and/or simplify your code base, including the usage of new features.
         </p>
 
+         <h3><a id="streams_api_changes_01021" href="#streams_api_changes_0102">Notable changes in 0.10.2.1</a></h3>
+         <p>
+            Parameter updates in <code>StreamsConfig</code>:
+        </p>
+          <ul>
+            <li> of particular importance to improve the resiliency of a Kafka Streams application are two changes to default parameters of producer <code>retries</code> and consumer <code>max.poll.interval.ms</code> </li>
+          </ul>
         <h3><a id="streams_api_changes_0102" href="#streams_api_changes_0102">Streams API changes in 0.10.2.0</a></h3>
 
         <p>
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 109097c0d8c..d165eb2bdcd 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -113,6 +113,14 @@ Kafka cluster before upgrading your clients. Version 0.10.2 brokers support 0.8.
     <li> See <a href="/{{version}}/documentation/streams#streams_api_changes_0102">Streams API changes in 0.10.2</a> for more details. </li>
 </ul>
 
+<h5><a id="upgrade_10201_notable" href="#upgrade_10201_notable">Notable changes in 0.10.2.1</a></h5>
+<ul>
+  <li> The default values for two configurations of the StreamsConfig class were changed to improve the resiliency of Kafka Streams applications. The internal Kafka Streams producer <code>retries</code> default value was changed from 0 to 10. The internal Kafka Streams consumer <code>max.poll.interval.ms</code>  default value was changed from 300000 to <code>Integer.MAX_VALUE<code>.
+  </li>
+</ul>
+
+
+
 <h5><a id="upgrade_1020_notable" href="#upgrade_1020_notable">Notable changes in 0.10.2.0</a></h5>
 <ul>
     <li>The Java clients (producer and consumer) have acquired the ability to communicate with older brokers. Version 0.10.2 clients
@@ -397,4 +405,4 @@ Release 0.7 is incompatible with newer releases. Major changes were made to the
 
 </script>
 
-<div class="p-upgrade"></div>
\ No newline at end of file
+<div class="p-upgrade"></div>