Guozhang Wang created KAFKA-5350:
------------------------------------

             Summary: Modify Unstable annotations in Streams API
                 Key: KAFKA-5350
                 URL: https://issues.apache.org/jira/browse/KAFKA-5350
             Project: Kafka
          Issue Type: Bug
          Components: streams
            Reporter: Guozhang Wang
            Assignee: Guozhang Wang
             Fix For: 0.11.0.0


As discussed in the email thread: 
https://www.mail-archive.com/dev@kafka.apache.org/msg72581.html

We are going to make the following changes to the Streams API compatibility 
annotations:

1. For "o.a.k.streams.errors" and "o.a.k.streams.state" packages: remove the 
annotations except `Stores`.

2. For "o.a.k.streams.kstream": remove the annotations except "KStream", 
"KTable", "GroupedKStream", "GroupedKTable", "GlobalKTable" and 
"KStreamBuilder".

3. For all the other public classes, including "o.a.k.streams.processor", 
change the annotation to "Evolving", which means "we might break compatibility 
at minor releases (i.e. 0.12.x, 0.13.x, 1.0.x etc) only". 

The ultimate goal is to make sure we won't break anything going forward, hence 
in the future we should remove all the annotations to make that clear. The 
above changes in 0.11.0.0 is to give us some "buffer time" in case there are 
some major API change proposals after the release.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Reply via email to