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

["Till Rohrmann (Jira)" <ji...@apache.org>]

Till Rohrmann created FLINK-25352:
-------------------------------------

             Summary: 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: 1.15.0
            Reporter: Till Rohrmann
             Fix For: 1.15.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.1#820001)