Skip to content

Conversation

bivouak
Copy link

@bivouak bivouak commented Aug 8, 2025

What is the purpose of the change

Simple typo fix in the docstring/javadoc.

@flinkbot
Copy link
Collaborator

flinkbot commented Aug 8, 2025

CI report:

Bot commands The @flinkbot bot supports the following commands:
  • @flinkbot run azure re-run the last Azure build

@davidradl
Copy link
Contributor

davidradl commented Aug 13, 2025

@bivouak Please could you follow https://flink.apache.org/how-to-contribute/contribute-code/ and start the tile of the PR with either [Jira number] or [hotfix]. In this case it looks like a hotfix.

Note it not a docs change it is a comments change.

* once the an event with timestamp T was encountered, no events older than {@code T - B} will
* follow any more.
* once an event with timestamp T was encountered, no events older than {@code T - B} will
* follow anymore.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This text seems to be almost an incorrect copy of the class javadoc .

I think a link to the class javadoc, with the existing @see or similar and then javadoc including the @param would seem more appropriate. Maybe something like

Creates a watermark strategy for @see BoundedOutOfOrdernessWatermarks using the supplied out-of-order bound
@param maxOutOfOrderness out-of-order bound duration.

@github-actions github-actions bot added community-reviewed PR has been reviewed by the community. and removed community-reviewed PR has been reviewed by the community. labels Aug 15, 2025
@github-actions github-actions bot added community-reviewed PR has been reviewed by the community. and removed community-reviewed PR has been reviewed by the community. labels Aug 23, 2025
@github-actions github-actions bot added community-reviewed PR has been reviewed by the community. and removed community-reviewed PR has been reviewed by the community. labels Aug 26, 2025
@github-actions github-actions bot added community-reviewed PR has been reviewed by the community. and removed community-reviewed PR has been reviewed by the community. labels Sep 3, 2025
@bivouak bivouak changed the title Fix watermark documentation [hotfix] Fix watermark documentation Sep 3, 2025
@bivouak bivouak changed the title [hotfix] Fix watermark documentation [hotfix] Fix watermark javadoc Sep 3, 2025
@github-actions github-actions bot added community-reviewed PR has been reviewed by the community. and removed community-reviewed PR has been reviewed by the community. labels Sep 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
community-reviewed PR has been reviewed by the community.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants