kafka-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From guozh...@apache.org
Subject kafka git commit: MINOR: update Streams docs for KIP-123
Date Thu, 01 Jun 2017 22:27:51 GMT
Repository: kafka
Updated Branches:
  refs/heads/0.11.0 1db85b1a2 -> c2c1a6aa3


MINOR: update Streams docs for KIP-123

Author: Matthias J. Sax <matthias@confluent.io>

Reviewers: Ismael Juma, Ewen Chesklack-Postava, Bill Bejeck, Guozhang Wang

Closes #3194 from mjsax/minor-update-docs-for-kip-123

(cherry picked from commit 1e350b860acd8e3fcc6ee296e9babbdfe4bcd365)
Signed-off-by: Guozhang Wang <wangguoz@gmail.com>


Project: http://git-wip-us.apache.org/repos/asf/kafka/repo
Commit: http://git-wip-us.apache.org/repos/asf/kafka/commit/c2c1a6aa
Tree: http://git-wip-us.apache.org/repos/asf/kafka/tree/c2c1a6aa
Diff: http://git-wip-us.apache.org/repos/asf/kafka/diff/c2c1a6aa

Branch: refs/heads/0.11.0
Commit: c2c1a6aa367a37677fedb517437fa1422217abfc
Parents: 1db85b1
Author: Matthias J. Sax <matthias@confluent.io>
Authored: Thu Jun 1 15:27:41 2017 -0700
Committer: Guozhang Wang <wangguoz@gmail.com>
Committed: Thu Jun 1 15:27:47 2017 -0700

----------------------------------------------------------------------
 docs/streams.html | 31 +++++++++++++++++++++++++------
 docs/upgrade.html |  2 ++
 2 files changed, 27 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/kafka/blob/c2c1a6aa/docs/streams.html
----------------------------------------------------------------------
diff --git a/docs/streams.html b/docs/streams.html
index b70074a..4528d9d 100644
--- a/docs/streams.html
+++ b/docs/streams.html
@@ -808,6 +808,12 @@ $ java -cp path-to-app-fatjar.jar com.example.MyStreamsApp
         <h2><a id="streams_upgrade_and_api" href="#streams_upgrade_and_api">Upgrade
Guide and API Changes</a></h2>
 
         <p>
+        If you want to upgrade from 0.10.2.x to 0.11.0 you don't need to do any code changes
as the public API is fully backward compatible.
+        However, some configuration parameters were deprecated and thus it is recommend to
update your code eventually to allow for future upgrades.
+        See <a href="#streams_api_changes_0110">below</a> a complete list of
0.11.0 API and semantical changes that allow you to advance your application and/or simplify
your code base, including the usage of new features.
+        </p>
+
+        <p>
         If you want to upgrade from 0.10.1.x to 0.10.2, see the <a href="/{{version}}/documentation/#upgrade_1020_streams">Upgrade
Section for 0.10.2</a>.
         It highlights incompatible changes you need to consider to upgrade your code and
application.
         See <a href="#streams_api_changes_0102">below</a> a complete list of
0.10.2 API and semantical changes that allow you to advance your application and/or simplify
your code base, including the usage of new features.
@@ -819,13 +825,26 @@ $ 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>:
+        <h3><a id="streams_api_changes_0110" href="#streams_api_changes_0110">Notable
changes in 0.11.0.0</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>
+        <ul>
+          <li> <code>timestamp.extractor</code> was deprecated and replaced
by <code>default.timestamp.extractor</code>
+          <li> <code>key.serde</code> was deprecated and replaced by <code>default.key.serde</code>
+          <li> <code>value.serde</code> was deprecated and replaced by
<code>default.value.serde</code>
+        </ul>
+
+        <h3><a id="streams_api_changes_01021" href="#streams_api_changes_01021">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>

http://git-wip-us.apache.org/repos/asf/kafka/blob/c2c1a6aa/docs/upgrade.html
----------------------------------------------------------------------
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 6487a62..ab1ddaf 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -76,6 +76,8 @@
         The default value for this is 3 seconds.
         During development and testing it might be desirable to set this to 0 inorder to
not delay test execution time.
     </li>
+    <li>Streams API configuration parameters <code>timestamp.extractor</code>,
<code>key.serde</code>, and <code>value.serde</code> were deprecated
and
+        replaced by <code>default.timestamp.extractor</code>, <code>default.key.serde</code>,
and <code>default.value.serde</code>, respectively.</li>
 </ul>
 
 <h5><a id="upgrade_1100_new_protocols" href="#upgrade_1100_new_protocols">New
Protocol Versions</a></h5>


Mime
View raw message