JimGalasyn commented on a change in pull request #11003:
URL: https://github.com/apache/kafka/pull/11003#discussion_r666503902
##########
File path: streams/src/main/java/org/apache/kafka/streams/StreamsConfig.java
##########
@@ -427,8 +427,18 @@
/** {@code max.task.idle.ms} */
public static final String MAX_TASK_IDLE_MS_CONFIG = "max.task.idle.ms";
- private static final String MAX_TASK_IDLE_MS_DOC = "Maximum amount of time
in milliseconds a stream task will stay idle when not all of its partition
buffers contain records," +
- " to avoid potential out-of-order record processing across multiple
input streams.";
+ private static final String MAX_TASK_IDLE_MS_DOC = "This config controls
whether joins and merges"
+ + " may produce out-of-order results."
+ + " The config value is the maximum amount of time in milliseconds a
stream task will stay idle"
+ + " when it is fully caught up on some (but not all) input partitions"
+ + " to wait for producers to send additional records and avoid
potential"
+ + " out-of-order record processing across multiple input streams."
+ + " The default (zero) does not wait for producers to send more
records,"
+ + " but it does wait to fetch data that is already present on the
brokers."
+ + " This default means that for records that are already present on
the brokers,"
+ + " Streams will process them in timestamp order."
+ + " The setting of -1 disables idling entirely and processes any
locally available data,"
Review comment:
```suggestion
+ " Set to -1 to disable idling entirely and process any locally
available data,"
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
