Jaikiran, After the last KIP discussion, I've been tasked with proposing a policy to address general rules across all public interfaces including APIs, configs, metrics, and command line interfaces, but haven't had a chance to send out a concrete proposal yet.
I'll send that out to the dev list soon, but changes made now need some special consideration anyway since Kafka releases up to now haven't made any compatibility guarantees. Semantic versioning is probably a good baseline, but even the choice of 0.8.3 vs. 0.9.0 for our next release is pretty arbitrary since Kafka has so far made breaking changes even in minor releases. Until we resolve the more general compatibility rules, I'd suggest we let this particular issue progress with the basic approach of providing one minor point release of compatibility -- guarantee compatibility with the previous interface for one release, providing a window for transition, then removing the functionality in the subsequent release. For now, this just means adding the JIRA to 0.9.x that removes the functionality, and if we decide on a different policy, we can just adjust the Fix Version for the removal of the old tool. -Ewen On Thu, Jul 2, 2015 at 12:19 AM, Jaikiran Pai <jai.forums2...@gmail.com> wrote: > Just curious about deprecation policy and the version schemes. Consider a > certain feature was deprecated in 0.9.2, so a WARN gets logged in that > version. Does that now mean a (bug fix release) 0.9.3 will drop that > feature? Shouldn't the dropping of the feature be done in a 0.10.0 release > instead? > > -Jaikiran > > On Thursday 02 July 2015 06:27 AM, Ashish Singh wrote: > >> Hey Guys, >> >> In last KIP hangout, we decided on following path for deprecating >> ConsumerOffsetChecker. >> >> 1. Add deprecation warning to the tool for one release. In this case, the >> warning will be added in 0.9.0. >> 2. Drop it completely in next release, 0.9.1. >> >> I have updated the (KIP-23){ >> https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=56852556 >> } >> accordingly. {KAFKA-2307}( >> https://issues.apache.org/jira/browse/KAFKA-2307) >> is to remind up that we need to drop the tool in 0.9.1. >> >> Let me know if I am missing out on any step that we decided on for the >> deprecation. >> >> > -- Thanks, Ewen