flink-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Alexander Alexandrov <alexander.s.alexand...@gmail.com>
Subject Re: Tagging Flink classes with InterfaceAudience and InterfaceStability
Date Tue, 27 Jan 2015 14:58:11 GMT
I don't get the difference between Private and LimitedPrivate, but
otherwise seems like quite a nice idea.

It will be also good if we can agree upon what these tags actually mean and
add this meaning to the documentation.

2015-01-27 15:46 GMT+01:00 Robert Metzger <rmetzger@apache.org>:

> Hi,
>
> Hadoop has annotations for tagging the stability and audience of classes
> and methods.
>
> Through that, you can have @InterfaceAudience.Public, Private,
> LimitedPrivate
> and also @InterfaceStability.Evolving, Unstable, and Stable.
>
> I guess there are tools which allow to automatically check if interfaces,
> which are marked as Stable have been changed between releases (or by pull
> requests).
>
> I think such annotations are crucial if we want to guarantee interface
> stability between releases.
>
> What do you think? Should we add those annotations? Which one would you
> like to add?
>
>
> Robert
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message