[jira] [Commented] (FLINK-3376) Add an illustration of Event Time and Watermarks to the docs

["Stephan Ewen (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/FLINK-3376?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15138781#comment-15138781 ] 

Stephan Ewen commented on FLINK-3376:
-------------------------------------

Some of that information is available, but hidden deep in the Streaming API guide.

I vote to link this page on the same level as the Batch and Streaming API guide

> Add an illustration of Event Time and Watermarks to the docs
> ------------------------------------------------------------
>
>                 Key: FLINK-3376
>                 URL: https://issues.apache.org/jira/browse/FLINK-3376
>             Project: Flink
>          Issue Type: Improvement
>          Components: Documentation
>    Affects Versions: 0.10.1
>            Reporter: Stephan Ewen
>            Priority: Critical
>             Fix For: 1.0.0
>
>
> Users seem to get confused about how event time and watermarks work.
> We need to add documentation with two sections:
> 1. Event time and watermark progress in general
>   - Watermarks are generated at the sources
>   - How Watermarks progress through the streaming data flow
> 2. Ways that users can generate watermarks
>   - EventTimeSourceFunctions
>   - AscendingTimestampExtractor
>   - TimestampExtractor general case



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)