Return-Path: X-Original-To: apmail-accumulo-dev-archive@www.apache.org Delivered-To: apmail-accumulo-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 34E0410B54 for ; Wed, 3 Dec 2014 15:47:34 +0000 (UTC) Received: (qmail 67453 invoked by uid 500); 3 Dec 2014 15:47:34 -0000 Delivered-To: apmail-accumulo-dev-archive@accumulo.apache.org Received: (qmail 67420 invoked by uid 500); 3 Dec 2014 15:47:33 -0000 Mailing-List: contact dev-help@accumulo.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@accumulo.apache.org Delivered-To: mailing list dev@accumulo.apache.org Received: (qmail 67408 invoked by uid 99); 3 Dec 2014 15:47:33 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 03 Dec 2014 15:47:33 +0000 X-ASF-Spam-Status: No, hits=1.5 required=5.0 tests=HTML_MESSAGE,RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of busbey@cloudera.com designates 209.85.216.50 as permitted sender) Received: from [209.85.216.50] (HELO mail-qa0-f50.google.com) (209.85.216.50) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 03 Dec 2014 15:47:07 +0000 Received: by mail-qa0-f50.google.com with SMTP id w8so10394455qac.37 for ; Wed, 03 Dec 2014 07:46:21 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:content-type; bh=rM5lgu/abK3MG5oF0IV/8VpbiFR+dJYEBx2Eu6Q6j+o=; b=ZCpcPreOw8S/vPTzixf3HWWfN/PblC0C/MCZfwI07uY8pLotrSAtcSc5eyLvAAa0h8 NFzBJSBGQ12KJf6UT6dJXumlsaOZ6YAP/tUdXntOBDtFmQvlRU/PH1naJ42xnRRyNc4M 99FhGEgujEEUYuBmiUrQFvPPJ5ql12Mm5qro/ghNH4RsI+8j9eINxP8+gVltYOu3Iu4U TQQLyXw1UU0nv5oY9/XAf/GCmARnaJk6ciUJ9ECpQXfN4dtAECVgrEWc7TStEW6WRZJE 1l+l2dXkga4S4sfjU2tYqvZGm++wrvtCv5KD4IzkRmX3JeEpIsY9VsyotWickdmqO2fp JNHQ== X-Gm-Message-State: ALoCoQnIPJWUC72rOQM0inxcAB4QWBVE/KN9E7r/DU3zANQGDGpu2AJBY+SdSvZW/5fd9xVUJVa7 X-Received: by 10.229.104.199 with SMTP id q7mr8794340qco.8.1417621581573; Wed, 03 Dec 2014 07:46:21 -0800 (PST) MIME-Version: 1.0 Received: by 10.229.29.194 with HTTP; Wed, 3 Dec 2014 07:46:01 -0800 (PST) In-Reply-To: <1096155329.13214320.1417621068018.JavaMail.zimbra@comcast.net> References: <1096155329.13214320.1417621068018.JavaMail.zimbra@comcast.net> From: Sean Busbey Date: Wed, 3 Dec 2014 09:46:01 -0600 Message-ID: Subject: Re: [VOTE] API release policy for 1.7/2.0 To: "dev@accumulo apache. org" Content-Type: multipart/alternative; boundary=001a11338022cbcb29050951be84 X-Virus-Checked: Checked by ClamAV on apache.org --001a11338022cbcb29050951be84 Content-Type: text/plain; charset=UTF-8 On Wed, Dec 3, 2014 at 9:37 AM, wrote: > > > ----- Original Message ----- > > From: "Keith Turner" > To: "Accumulo Dev List" > Sent: Wednesday, December 3, 2014 10:31:53 AM > Subject: Re: [VOTE] API release policy for 1.7/2.0 > > On Tue, Dec 2, 2014 at 3:01 PM, Christopher wrote: > > > Following the conversation on the [VOTE] thread for ACCUMULO-3176, it > seems > > we require an explicit API guidelines at least for 1.7.0 and later until > > 2.0.0. > > > > I hereby propose we adopt the following guidelines for future releases > (if > > we produce any such releases) until 2.0.0: > > > > API additions are permitted in "major" 1.x releases (1.7, 1.8, 1.9, 1.10, > > etc.). > > API should be forwards and backwards compatible within a 1.x release (no > > new additions to the API in a "bugfix" release; e.g. 1.7.1). > > New API in 1.7.0 and later 1.x releases will not be removed in 2.0 > (though > > they may be deprecated in 2.0 and subject to removal in 3.0). > > Existing API in 1.7.0 will be preserved through 2.0, and should only be > > subject to removal if it was already deprecated prior to 1.7.0 (though > they > > may be deprecated in 2.0 and subject to removal in 3.0). > > > > -1 For the reason I stated earlier. I think we are setting ourselves to > waste time in the future debating this by not making a more firm decision > now about which deprecated methods will be dropped. In the earlier email I > listed two options, are there other options? > > It seems that we already had this discussion[1] and a conclusion[2]. No > vote though. > > [1] > http://mail-archives.apache.org/mod_mbox/accumulo-dev/201410.mbox/%3CCAL5zq9ah+G+oMqR_p5E09Cwyue0K2ztVoJ10h+GriKOvhe+ggQ@mail.gmail.com%3E > [2] > http://mail-archives.apache.org/mod_mbox/accumulo-dev/201410.mbox/%3CCAL5zq9aaiCCO%2B%2BtwkKzNzw_xpjTQtPj%3DV%3DrEFUDR-eKoSAHBuQ%40mail.gmail.com%3E > > That discussion did a good job of coming to consensus on not remove any deprecated methods earlier than 2.0. I believe Keith's concern is that he'd like to specify what is and is not getting dropped at 2.0. The original proposal only says that things added in 1.7+ won't be dropped earlier than 3.0. It leaves the fate of things deprecated prior to 1.7 ambiguous in the 2.0 release. Did I correctly restate your concern Keith? -- Sean --001a11338022cbcb29050951be84--