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