[jira] [Updated] (BEAM-13160) Clarify windowing behavior in Javadoc

["Beam JIRA Bot (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/BEAM-13160?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Beam JIRA Bot updated BEAM-13160:
---------------------------------
    Labels: stale-P2  (was: )

> Clarify windowing behavior in Javadoc
> -------------------------------------
>
>                 Key: BEAM-13160
>                 URL: https://issues.apache.org/jira/browse/BEAM-13160
>             Project: Beam
>          Issue Type: Improvement
>          Components: sdk-java-core
>            Reporter: David Huntsperger
>            Priority: P2
>              Labels: stale-P2
>
> Feedback from a user:
> {quote}I'm confused by the documentation around AfterProcessingTime.pastFirstElementInPane(). The javadoc text seems somewhat contrived:
> "Creates a trigger that fires when the current processing time passes the processing time at which this trigger saw the first element in a pane."
> Doesn't this just mean that the trigger fires as soon it sees the first element in the pane? Processing time, IIUC, always increases monotonically.
> The text in the Beam documentation is also not very illuminating:
> "the AfterProcessingTime.pastFirstElementInPane() trigger emits a window after a certain amount of processing time has passed since data was received"
> It's not clear what the "certain amount of processing time" is. Is it some small, fixed epsilon? Is it configurable?
> Another point of confusion: there seems to be inconsistency between the AfterWatermark Javadoc and the Beam documentation on triggers w.r.t. the behavior of the default trigger. The Javadoc makes it sound as though the default trigger is sufficient for handling late data. However, the Beam documentation states that late data is discarded. It's not clear which is correct. It seems that the Javadoc is the misleading one, as it omits discussion of accumulation modes and allowed lateness.{quote}
> Note: If this requires additional work after the changes to the Javadoc, please assign to the website component after the changes to the Java source files are complete.



--
This message was sent by Atlassian Jira
(v8.20.1#820001)