On Fri, Feb 8, 2013 at 2:40 PM, Vincent Massol <vinc...@massol.net> wrote: > Hi Paul, > > On Feb 8, 2013, at 1:22 PM, Paul Libbrecht <p...@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 going to > 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 and 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 module as >>>> experimental) > > _______________________________________________ > devs mailing list > devs@xwiki.org > http://lists.xwiki.org/mailman/listinfo/devs -- Thomas Mortagne _______________________________________________ devs mailing list devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs