[jira] [Updated] (FLINK-25352) Update stability annotations to include the since and missedGraduations fields

["Weijie Guo (Jira)" <ji...@apache.org>]

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

Weijie Guo updated FLINK-25352:
-------------------------------
    Affects Version/s: 2.1.0
                           (was: 1.15.0)

> Update stability annotations to include the since and missedGraduations fields
> ------------------------------------------------------------------------------
>
>                 Key: FLINK-25352
>                 URL: https://issues.apache.org/jira/browse/FLINK-25352
>             Project: Flink
>          Issue Type: Sub-task
>    Affects Versions: 2.1.0
>            Reporter: Till Rohrmann
>            Assignee: Jing Ge
>            Priority: Major
>             Fix For: 2.0.0
>
>
> In order to implement the graduation process outlined in FLIP-197, we need to extend our stability annotations to include a {{since}} and {{missedGraduations}} fields. 
> The idea of {{since}} is that it tells since when something has this stability guarantee.
> The idea of the {{missedGraduations}} field is to record reasons why an API has not been graduated.
> {code}
> @Target(ElementType.TYPE)
> public @interface PublicEvolving {
>  
>    FlinkVersion since();
>  
>    GraduationMiss[] missedGraduations();
> }
>  
> public @interface GraduationMiss {
>    FlinkVersion graduation();
>  
>    String reason();
> }
>  
> // Usage
> @PublicEvolving(
>        since = FlinkVersion.V1_11_0,
>        missedGraduations = {
>            @GraduationMiss(graduation = FlinkVersion.V1_13_0, reason = "foobar"),
>            @GraduationMiss(graduation = FlinkVersion.V1_14_0, reason = "barfoo")
>        })
> public class Foobar {}
> {code}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)