Gianluca 's plan is better.
I think step 5 can be the step where depreciated methods exist but they
are redirecting to the new methods if this is possible, otherwise there
have to be removed.
The key point to the whole plan is to give users the time to update their
code.
Regards,
Christos
Sent from my Galaxy Note!
On Dec 9, 2012 8:06 PM, "Gianluca Sforna" <gia...@gmail.com> wrote:
> On Sat, Dec 8, 2012 at 7:01 AM, Greg Landrum <greg.land...@gmail.com>
> wrote:
> > My current plan is to keep this branch in sync with the trunk through (at
> > least) the Q4 2012 release and then consider moving it onto the trunk and
> > creating a v1 API branch in Q1 of next year. I guess I should be able to
> > keep the v1 API branch in sync, at least in terms of bug fixes, for
> another
> > 2-3 releases.
>
> I believe a commonly accepted approach to this kind of issues is something
> like:
>
> 1. add warnings about the deprecated or changed methods, but keep the
> current behavior so code do not break, but becomes verbose when called
> 2. add the v2 methods.
> 3. release Q4 2012
> 4. keep the warnings around as much as you feel is fair to give time
> for the clients to port code
> 5. make the real break (remove deprecated methods, change method signature)
> 6. release a new version with the api break
>
> Cheers
>
> G.
>
> --
> Gianluca Sforna
>
> http://morefedora.blogspot.com
> http://identi.ca/giallu - http://twitter.com/giallu
>
>
> ------------------------------------------------------------------------------
> LogMeIn Rescue: Anywhere, Anytime Remote support for IT. Free Trial
> Remotely access PCs and mobile devices and provide instant support
> Improve your efficiency, and focus on delivering more value-add services
> Discover what IT Professionals Know. Rescue delivers
> http://p.sf.net/sfu/logmein_12329d2d
> _______________________________________________
> Rdkit-devel mailing list
> Rdkit-devel@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/rdkit-devel
>
------------------------------------------------------------------------------
LogMeIn Rescue: Anywhere, Anytime Remote support for IT. Free Trial
Remotely access PCs and mobile devices and provide instant support
Improve your efficiency, and focus on delivering more value-add services
Discover what IT Professionals Know. Rescue delivers
http://p.sf.net/sfu/logmein_12329d2d
_______________________________________________
Rdkit-devel mailing list
Rdkit-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/rdkit-devel
