You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@flink.apache.org by "Yun Gao (Jira)" <ji...@apache.org> on 2022/04/13 06:28:05 UTC
[jira] [Updated] (FLINK-25352) Update stability annotations to include the since and missedGraduations fields
[ https://issues.apache.org/jira/browse/FLINK-25352?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Yun Gao updated FLINK-25352:
----------------------------
Fix Version/s: 1.16.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: 1.15.0
> Reporter: Till Rohrmann
> Priority: Major
> Fix For: 1.15.0, 1.16.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)