Very cool! Congrats! :) My only comment is that, as Gwen pointed out in the first email, it is a set of API compatibility annotations, but the name is InterfaceStability.
Wouldn't ApiStability be a better name? InterfaceStability looks a bit restrictive, imho. https://github.com/apache/kafka/pull/133/files Cheers, Edward Good annotations. I can see a few future usages :) Jiangjie (Becket) Qin On Wed, Aug 12, 2015 at 3:05 PM, Gwen Shapira <g...@confluent.io> wrote: > Hi Team Kafka, > > Ewen just added stability annotations to Apache Kafka (KAFKA-2429). > > In the same PR, we marked the new Consumer API as "unstable" since we are > still actively iterating on them. The goal is to mark them as "evolving" > before the next release and after one release to validate them, we will > mark them as "stable". > > When adding new public APIs, we encourage you to think of their stage of > development and annotate correctly. > > The usage is: > > - unstable - can change at any time > - evolving - can break compatibility at minor releases (i.e. 0.9 may be > incompatible with 0.8) > - stable - will only break compatibility at major releases (1.0, 2.0, etc) > > Enjoy! > > Gwen >
