Re: Usage of PublicEvolving annotation

2022-07-12 Thread Timo Walther
Hi all, let me add a few more words on this topic: The @PublicEvolving interface is kind of a staging annotation for @Public. We still need to be careful when to change classes with @PublicEvolving annotation. Usually, it still involves a proper deprecation process over 1-2 releases to give d

Re: Usage of PublicEvolving annotation

2022-07-10 Thread Konstantin Knauf
Hi Blake, thank you for reaching out. @PublicEvolving interface can only be changed with a minor release of Apache Flink (e.g. 1.6). While the JavaDoc is indeed ambiguous there was a FLIP recently that discussed this topic: https://cwiki.apache.org/confluence/display/FLINK/FLIP-196%3A+Source+API+s

Usage of PublicEvolving annotation

2022-07-09 Thread Blake Wilson
Hello, I've noticed the usage of "PublicEvolving" in some Flink classes described as follows /** * Annotation to mark classes and methods for public use, but with evolving interfaces. * * Classes and methods with this annotation are intended for public use and have stable behavior. * However,