[jira] [Created] (KAFKA-5350) Modify Unstable annotations in Streams API

["Guozhang Wang (JIRA)" <ji...@apache.org>]

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)