Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[FLINK-19197] [docs] Add documentation for PersistedStateRegistry #147

Closed
wants to merge 1 commit into from

Conversation

tzulitai
Copy link
Contributor

Preview of the new documentation:

image

Copy link
Contributor

@sjwiesman sjwiesman left a comment

Choose a reason for hiding this comment

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

few small nits but looks good.

### Dynamic State Registration

Using the above state types, a function's persisted state must be defined eagerly. You cannot use those state types to
register new persisted state during invocations (i.e. in the ``invoke`` method) or after the function instance is created.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
register new persisted state during invocations (i.e. in the ``invoke`` method) or after the function instance is created.
register a new persisted state during invocations (i.e., in the ``invoke`` method) or after the function instance is created.

Using the above state types, a function's persisted state must be defined eagerly. You cannot use those state types to
register new persisted state during invocations (i.e. in the ``invoke`` method) or after the function instance is created.

If dynamic state registration is required, you can use a ``PersistedStateRegistry`` to achieve that:
Copy link
Contributor

Choose a reason for hiding this comment

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

I can't exactly explain why, but the way you wrote it sounds off to me.

Suggested change
If dynamic state registration is required, you can use a ``PersistedStateRegistry`` to achieve that:
If dynamic state registration is required, it can be achieved using a ``PersistedStateRegistry``:

@tzulitai
Copy link
Contributor Author

Thanks for the review @sjwiesman! Merging this now (with your suggestions applied).

@tzulitai tzulitai closed this in 533e77f Sep 15, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
2 participants