[jira] [Created] (FLINK-6607) Confusing statement in docs that Kafka 010 consumer does not require timestamp extractors

[Shang Yuanchun (Jira)]

Tzu-Li (Gordon) Tai created FLINK-6607:
------------------------------------------

             Summary: Confusing statement in docs that Kafka 010 consumer does not require timestamp extractors
                 Key: FLINK-6607
                 URL: https://issues.apache.org/jira/browse/FLINK-6607
             Project: Flink
          Issue Type: Improvement
          Components: Documentation, Kafka Connector
            Reporter: Tzu-Li (Gordon) Tai


In https://ci.apache.org/projects/flink/flink-docs-release-1.2/dev/connectors/kafka.html#using-kafka-timestamps-and-flink-event-time-in-kafka-010, the docs state that the Kafka 010 consumer does not require timestamp extractors because the Kafka records' timestamps can be used.

While this is true, it is confusing for the Kafka 010 consumer because currently timestamp extraction and watermark generating is bound to a single `AssignerWithXXXWatermarks` interface. This may cause users to misunderstand that even watermark generating isn't required also.

We perhaps should strengthen the clarification of this a bit more in that part of the docs to avoid confusion.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)