ignite-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Alexey Goncharuk <alexey.goncha...@gmail.com>
Subject Re: [DISCUSS] Public API deprecation rules
Date Thu, 13 Feb 2020 13:38:09 GMT
I've created a wiki page based on the vote results [1]. Feel free to update
the page if it seems incomplete.


чт, 6 февр. 2020 г. в 20:17, Alexey Goncharuk <alexey.goncharuk@gmail.com>:

> Ivan, thanks, I agree, added this clause:
> The vote we are going to have is reduced to two choices so far:
>  * 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.
>  * Allow to deprecate the old APIs even when new APIs are marked with
> @IgniteExperimental to explicitly notify users that old APIs will be
> removed in the next major release AND new APIs are available
> Neither of cases prohibits deprecation of an API without a replacement if
> community decided so.
> Are we good to go?

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