Re: [xwiki-devs] [Brainstorming] Handling "young" APIs for backward compatibility

+1, but I have the impression that @unstable would be more meaningful On Fri, Feb 8, 2013 at 2:49 PM, Thomas Mortagne <thomas.mortagne(a)xwiki.com>wrote;wrote: > On Fri, Feb 8, 2013 at 2:40 PM, Vincent Massol <vincent(a)massol.net>

> > Hi Paul, > > > > On Feb 8, 2013, at 1:22 PM, Paul Libbrecht <paul(a)hoplahup.net> wrote: > > > >> Doesn't the @deprecated annotation actually does exactly the job? > >> (except it has to be interpreted as meaning something else than "old > code", but "do not use code"). > > > > @Deprecated means something different. It's about some code that you > shouldn't use because we no longer think it's good to use and it's

> be removed in the future. > > > > This is not what a @beta or @experimental annotation would mean. They > would mean "this is a new api that you can use but it's not stable yet

> may change in the future so be prepared to update your code if that > happens". > > Plus @deprecated is technically pretty stable API while @beta can be > broken anytime. > > > > > Thanks > > -Vincent > > > >> paul > >> > >> > >> On 8 févr. 2013, at 12:45, Thomas Mortagne wrote: > >> > >>>> * Proposal 1 (internal package): > >>>> - Vincent > >>>> - Marius > >>>> > >>>> * Proposal 2 (experimental package) > >>>> - Caleb > >>>> > >>>> * Proposal 3 (@Beta/@Experimental annotation) > >>>> - Thomas > >>>> - Edy > >>>> > >>>> * Other proposal > >>>> - Denis (use 1) for small changes and only use RN to mark new

-- Denis Gervalle SOFTEC sa - CEO eGuilde sarl - CTO _______________________________________________ devs mailing list devs(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs