SIK Docs for Send Timeout Change

Author: garyrussell

src/reference/asciidoc/si-kafka.adoc

@@ -93,6 +93,10 @@ Flushing after sending several messages might be useful if you are using the `li
 By default, the expression looks for a `Boolean` value in the `KafkaIntegrationHeaders.FLUSH` header (`kafka_flush`).
 The flush will occur if the value is `true` and not if it's `false` or the header is absent.
 
+Starting with version 3.3.1, the `KafkaProducerMessageHandler` `sendTimeoutExpression` default has changed from 10 seconds to the `delivery.timeout.ms` Kafka producer property `+ 5000` so that the actual Kafka error after a timeout is propagated to the application, instead of a timeout generated by this framework.
+This has been changed for consistency because you may get unexpected behavior (Spring may timeout the send, while it is actually, eventually, successful).
+IMPORTANT: That timeout is 120 seconds by default so you may wish to reduce it to get more timely failures.
+
 ===== Java Configuration
 
 The following example shows how to configure the Kafka outbound channel adapter with Java:
@@ -445,6 +449,10 @@ If your code invokes the gateway behind a synchronous https://docs.spring.io/spr
 IMPORTANT: The gateway does not accept requests until the reply container has been assigned its topics and partitions.
 It is suggested that you add a `ConsumerRebalanceListener` to the template's reply container properties and wait for the `onPartitionsAssigned` call before sending messages to the gateway.
 
+Starting with version 3.3.1, the `KafkaProducerMessageHandler` `sendTimeoutExpression` default has changed from 10 seconds to the `delivery.timeout.ms` Kafka producer property `+ 5000` so that the actual Kafka error after a timeout is propagated to the application, instead of a timeout generated by this framework.
+This has been changed for consistency because you may get unexpected behavior (Spring may timeout the send, while it is actually, eventually, successful).
+IMPORTANT: That timeout is 120 seconds by default so you may wish to reduce it to get more timely failures.
+
 ===== Java Configuration
 
 The following example shows how to configure a gateway with Java: