ignite-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ivan Rakov <ivan.glu...@gmail.com>
Subject Re: [VOTE] Allow or prohibit a joint use of @deprecated and @IgniteExperimental
Date Mon, 10 Feb 2020 09:27:43 GMT
-1 Prohibit

>From my point of view, deprecation of the existing API will confuse users
in case API suggested as a replacement is marked with @IgniteExperimental.

On Mon, Feb 10, 2020 at 12:20 PM Nikolay Izhikov <nizhikov@apache.org>
wrote:

> +1
>
> > 10 февр. 2020 г., в 11:57, Andrey Mashenkov <andrey.mashenkov@gmail.com>
> написал(а):
> >
> > -1 Prohibit.
> >
> > We must not deprecate old API without have a new stable well-documented
> > alternative and a way to migrate to new one.
> >
> >
> > On Mon, Feb 10, 2020 at 11:02 AM Alexey Goncharuk <agoncharuk@apache.org
> >
> > wrote:
> >
> >> Dear Apache Ignite community,
> >>
> >> We would like to conduct a formal vote on the subject of whether to
> allow
> >> or prohibit a joint existence of @deprecated annotation for an old API
> >> and @IgniteExperimental [1] for a new (replacement) API. The result of
> this
> >> vote will be formalized as an Apache Ignite development rule to be used
> in
> >> future.
> >>
> >> The discussion thread where you can address all non-vote messages is
> [2].
> >>
> >> The votes are:
> >> *[+1 Allow]* Allow to deprecate the old APIs even when new APIs are
> marked
> >> with @IgniteExperimental to explicitly notify users that an old APIs
> will
> >> be removed in the next major release AND new APIs are available.
> >> *[-1 Prohibit]* Never deprecate the old APIs unless the new APIs are
> stable
> >> and released without @IgniteExperimental. The old APIs javadoc may be
> >> updated with a reference to new APIs to encourage users to evaluate new
> >> APIs. The deprecation and new API release may happen simultaneously if
> the
> >> new API is not marked with @IgniteExperimental or the annotation is
> removed
> >> in the same release.
> >>
> >> Neither of the choices prohibits deprecation of an API without a
> >> replacement if community decides so.
> >>
> >> The vote will hold for 72 hours and will end on February 13th 2020 08:00
> >> UTC:
> >>
> >>
> https://www.timeanddate.com/countdown/to?year=2020&month=2&day=13&hour=8&min=0&sec=0&p0=utc-1
> >>
> >> All votes count, there is no binding/non-binding status for this.
> >>
> >> [1]
> >>
> >>
> https://github.com/apache/ignite/blob/master/modules/core/src/main/java/org/apache/ignite/lang/IgniteExperimental.java
> >> [2]
> >>
> >>
> http://apache-ignite-developers.2346864.n4.nabble.com/DISCUSS-Public-API-deprecation-rules-td45647.html
> >>
> >> Thanks,
> >> --AG
> >>
> >
> >
> > --
> > Best regards,
> > Andrey V. Mashenkov
>
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message