Github user NicoK commented on the issue:
https://github.com/apache/flink/pull/5790
Actually, more advanced schemes using `current watermark + 1` (which fires
with the next watermark) for the event time timer should also go into the
documentation. I'll extend the PR ...---
