Mailing-List: contact dev-help@accumulo.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@accumulo.apache.org
Received-SPF: neutral (athena.apache.org: local policy)
MIME-Version: 1.0
In-Reply-To: <54808E84.9090403@gmail.com>
References: 
 <CAL5zq9Y3Owj7dUd_ZZyhdGGZ7FQ+79ufgcLORJjjzUmMckBrsA@mail.gmail.com>
	<CADczPYRPmkJq-FOuwjp5NoYvF0Q+XdTrNSw0RmtR4uRkn=oNuw@mail.gmail.com>
	<CAGUtCHr1QsOEZ_dp4AA+LrsKMFWSYCCb6K13VT1WKBK+BnQkPA@mail.gmail.com>
	<CADczPYRn01Wgrj3upWTycwN8vFqWjNjduVEOV-0Y_wR=stKEHQ@mail.gmail.com>
	<CAGUtCHonoyQ_y8Oik45Sp9VL3_Hmr-AZr-iZqtSrCQYSn+AwrA@mail.gmail.com>
	<CADczPYQ6Stfu0Sb9AGDRQnXXNeKJHNL5otAUxQp4OZbqww4bJA@mail.gmail.com>
	<54808E84.9090403@gmail.com>
Date: Thu, 4 Dec 2014 11:52:06 -0500
Message-ID: 
 <CAGUtCHoJRMKwFUFZmXgdgB3R8mQi3LKHq5XiZWONnXhgoZTUPQ@mail.gmail.com>
Subject: Re: [VOTE] API release policy for 1.7/2.0
From: Keith Turner <keith@deenlo.com>
To: Accumulo Dev List <dev@accumulo.apache.org>
Content-Type: multipart/alternative; boundary=001a113a357ac602b8050966c7d6

--001a113a357ac602b8050966c7d6
Content-Type: text/plain; charset=UTF-8

On Thu, Dec 4, 2014 at 11:40 AM, Josh Elser <josh.elser@gmail.com> wrote:

> John Vines wrote:
>
>> Though I feel the biggest reasoning is our switch to semantic
>>>>
>>> versioning. And from semver.org,
>>
>>> >  >
>>>> >  >
>>>> >  >      1. MAJOR version when you make incompatible API changes
>>>> >  >
>>>> >  >
>>>> >  >
>>>>
>>> >  Right and dropping deprecated APIs is an incompatible change. Do you
>>> think
>>> >  the following two rules are reasonable?
>>> >
>>> >    * When API is deprecated, must offer replacement if feasible.
>>> >    * Can only drop deprecated method when MAJOR version is incremented
>>>
>> (there
>>
>>> >  are other proposed constraints on dropping deprecated methods)
>>> >
>>> >  If we follow the above, then we can not deprecate current API before
>>> >  introducing new API (because the replacement would not exist
>>> >  concurrently).  Also we can not drop the current API in 2.0.0 if its
>>> not
>>> >  deprecated.
>>>
>>
>> It is totally a reasonable statement for after 2.0.0. But for 2.0.0 I am
>> not okay making this guarantee because I would rather sacrifice backward
>> compatibility for an API that isn't plagued by shortcomings of the old API
>>
>
> Again, this is the fear/concern of impacting the new API due to supporting
> of the old which *may or may not even happen*.
>

Good point, we could adopt these rules now and never create a new API.  I
think we would be better off adopting this now regardless of wether not we
introduce a new API in the future.

Also, if we do eventually create an API.  How is it user unfriendly to have
the old API around in deprecated form?  The deprecation markings clearly
communicate that someone writing new code should not use the old API.
However it still allows existing code that users invested time into writing
to run w/o issue against 2.0.0.

--001a113a357ac602b8050966c7d6--