[ 
https://issues.apache.org/jira/browse/KAFKA-5350?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16030395#comment-16030395
 ] 

ASF GitHub Bot commented on KAFKA-5350:
---------------------------------------

GitHub user guozhangwang opened a pull request:

    https://github.com/apache/kafka/pull/3172

    KAFKA-5350: Modify unstable annotations in Streams API

    

You can merge this pull request into a Git repository by running:

    $ git pull https://github.com/guozhangwang/kafka 
K5350-compatibility-annotations

Alternatively you can review and apply these changes as the patch at:

    https://github.com/apache/kafka/pull/3172.patch

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #3172
    
----
commit 03e2974d9e359beeec9244e912b2d4377acf8991
Author: Guozhang Wang <wangg...@gmail.com>
Date:   2017-05-30T23:59:40Z

    modify compatbility annotations in Streams API

----


> 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