+1 I think @since annotation would be super helpful when upgrading Flink versions.
BTW, I proposed to add @since annotation to configuration options as well [1]. [1] https://issues.apache.org/jira/browse/FLINK-23700 Best, Paul Lam > 2022年6月6日 15:49，Jingsong Li <jingsongl...@gmail.com> 写道： > > Hi everyone, > > I'm a bit curious why we don't use the api since annotation. > > I found this annotation very useful when I am using other > dependencies, it tells me very directly the version of the API and > which API I used would break the compatibility of which version. > > For example, String in JDK. > > ``` > /* > * ... > * @since JDK1.0 > */ > public final class String { > /* > * @since 1.4 > */ > public CharSequence subSequence(...) {...} > } > > ``` > > Do you think this is helpful? > > Best, > Jingsong
