+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> wrote:
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 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(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs
--
Thomas Mortagne
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs