diff --git a/README.adoc b/README.adoc index e0ba22359..4f9b410d0 100644 --- a/README.adoc +++ b/README.adoc @@ -345,7 +345,7 @@ When an application starts, the initial position in each assigned partition depe If `resetOffsets` is `false`, normal Kafka consumer https://kafka.apache.org/documentation/#consumerconfigs_auto.offset.reset[`auto.offset.reset`] semantics apply. i.e. If there is no committed offset for a partition for the binding's consumer group, the position is `earliest` or `latest`. By default, bindings with an explicit `group` use `earliest`, and anonymous bindings (with no `group`) use `latest`. -These defaults can be overriden by setting the `startOffset` binding property. +These defaults can be overridden by setting the `startOffset` binding property. There will be no committed offset(s) the first time the binding is started with a particular `group`. The other condition where no committed offset exists is if the offset has been expired. With modern brokers (since 2.1), and default broker properties, the offsets are expired 7 days after the last member leaves the group. @@ -359,9 +359,9 @@ Following are two use cases when this might be used. Set `resetOffsets` to `true` and `startOffset` to `earliest`; the binding will perform a `seekToBeginning` on all newly assigned partitions. 2. Consuming from a topic containing events, where you are only interested in events that occur while this binding is running. -Set `resetOffsets` to `true` and `startOffset` to `latest`; the binding will perform a `seekToEnd` on akll newly assigned partitions. +Set `resetOffsets` to `true` and `startOffset` to `latest`; the binding will perform a `seekToEnd` on all newly assigned partitions. -IMPORTANT: If a rebalance occurs after the initial assignment, the seeks will only be performed on any newly assigned topics that were not assigned during the initial assignment. +IMPORTANT: If a rebalance occurs after the initial assignment, the seeks will only be performed on any newly assigned partitions that were not assigned during the initial assignment. For more control over topic offsets, see <>; when a listener is provided, `resetOffsets: true` is ignored.