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

ZhuoYu Chen commented on FLINK-24483:
-------------------------------------

[~trohrmann] 
@PublicEvolving is to show that the current class/interface can only be 
guaranteed to be stable in small versions, such as 1.1.1, 1.1.3 current 
class/interface are stable
@Public is to show that the current class/interface changes will only change 
between major versions, can guarantee that the current major version is stable, 
such as 1.1, 1.2, 1.3 current class/interface are stable,What I understand 
above is correct, right?

`Transitive closure for methods` I don't see anything that puts restrictions on 
it.

`Test plan` Where can I see the relevant demos or code?

> Document what is Public API and what compatibility guarantees Flink is 
> providing
> --------------------------------------------------------------------------------
>
>                 Key: FLINK-24483
>                 URL: https://issues.apache.org/jira/browse/FLINK-24483
>             Project: Flink
>          Issue Type: Sub-task
>          Components: API / DataStream, Documentation, Table SQL / API
>    Affects Versions: 1.14.0, 1.12.5, 1.13.2
>            Reporter: Piotr Nowojski
>            Priority: Blocker
>             Fix For: 1.15.0, 1.13.6, 1.14.3
>
>
> We should document:
> * What constitute of the Public API, what do 
> Public/PublicEvolving/Experimental/Internal annotations mean.
> * What compatibility guarantees we are providing forward (backward?) 
> functional/compile/binary compatibility for {{@Public}} interfaces?
> A good starting point: 
> https://cwiki.apache.org/confluence/plugins/servlet/mobile?contentId=44302796#content/view/62686683



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

Reply via email to