Improve documentation on EOS KStream requirements
Reviewer: Matthias J. Sax
@@ -736,6 +736,14 @@ streamsConfiguration.put(StreamsConfig.DEFAULT_TIMESTAMP_EXTRACTOR_CLASS_CONFIG,
and <code class="docutils literal"><span class="pre">transaction.state.log.min.isr</span></code>
to the number of brokers you want to use.
For more details see <a href="../core-concepts#streams_processing_guarantee">Processing Guarantees</a>.
+
+ <dl class="docutils">
+ <dt>Recommendation:</dt>
+ <dd>While it is technically possible to use EOS with any replication factor, using a replication factor lower
+ than 3 effectively voids EOS. Thus it is strongly recommended to use a replication factor of 3 (together with
+ <code>min.in.sync.replicas=2</code>). This recommendation applies to all topics (i.e. <code>__transaction_state</code>,
+ <code>__consumer_offsets</code>, Kafka Streams internal topics, and user topics).</dd>
+ </dl>
</div></blockquote>
</div>
<div class="section" id="replication-factor">
