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)
