Re: [DISCUSS] Add a "Beta" badge in the documentation to components in flink-staging

2015-03-30 Thread Robert Metzger
I filed the JIRA for the beta badge: https://issues.apache.org/jira/browse/FLINK-1800 On Mon, Mar 30, 2015 at 12:34 PM, Maximilian Michels wrote: > +1 for using annotations to mark the status of API classes/methods. I think > that is very good practice to manage backwards-compatibility. > > On S

Re: [DISCUSS] Add a "Beta" badge in the documentation to components in flink-staging

2015-03-30 Thread Maximilian Michels
+1 for using annotations to mark the status of API classes/methods. I think that is very good practice to manage backwards-compatibility. On Sun, Mar 29, 2015 at 8:20 PM, Henry Saputra wrote: > +1 to this. > > Was thinking about the same thing. > > - Henry > > > > On Sun, Mar 29, 2015 at 7:38 AM

Re: [DISCUSS] Add a "Beta" badge in the documentation to components in flink-staging

2015-03-29 Thread Henry Saputra
+1 to this. Was thinking about the same thing. - Henry On Sun, Mar 29, 2015 at 7:38 AM, Robert Metzger wrote: > Hi, > > In an offline discussion with other Flink committers, we came up with the > idea to mark new components from the "flink-staging" module with a "Beta" > badge in the document

Re: [DISCUSS] Add a "Beta" badge in the documentation to components in flink-staging

2015-03-29 Thread Stephan Ewen
I also like the idea +1 There was a discussion about tagging public API classes and methods, to make it very clear what APIs should be stable across versions and what might change. Can we solve these things together: public class ApiVisibility { public static @interface Public {}; publ

Re: [DISCUSS] Add a "Beta" badge in the documentation to components in flink-staging

2015-03-29 Thread Till Rohrmann
+1 On Sun, Mar 29, 2015 at 5:04 PM, Chiwan Park wrote: > +1 > > Good idea. Users can accept API changes of “flink-staging” module with > “Beta" badge. > > Regards. > Chiwan Park (Sent with iPhone) > > > > On Mar 29, 2015, at 11:38 PM, Robert Metzger > wrote: > > > > Hi, > > > > In an offline di

Re: [DISCUSS] Add a "Beta" badge in the documentation to components in flink-staging

2015-03-29 Thread Chiwan Park
+1 Good idea. Users can accept API changes of “flink-staging” module with “Beta" badge. Regards. Chiwan Park (Sent with iPhone) > On Mar 29, 2015, at 11:38 PM, Robert Metzger wrote: > > Hi, > > In an offline discussion with other Flink committers, we came up with the > idea to mark new comp

[DISCUSS] Add a "Beta" badge in the documentation to components in flink-staging

2015-03-29 Thread Robert Metzger
Hi, In an offline discussion with other Flink committers, we came up with the idea to mark new components from the "flink-staging" module with a "Beta" badge in the documentation. This way, we make it very clear that the component is still under heavy development. If we agree on this, I'll file a