On Mon, 2014-06-23 at 20:38 +0100, sebb wrote: ...
> >> > ... > >> > > >> >> 2) > >> >> "Please note that new features included in this release are still > >> >> considered experimental and > >> >> their API may change in the future 4.4 alpha and beta releases." > >> >> > >> >> I think this also needs to be made more specific, e.g. by adding a > >> >> note to the sections which detail the the new features. > >> >> Ideally the Javadoc should also state which features are experimental. > >> >> > >> > > >> > All new features are marked with @since 4.4 tag in Javadocs. > >> > >> But are ALL the @since 4.4 methods subject to change? > >> > > > > Naturally. That is the whole point of having alpha releases, is that > > not? > > In which case, it should be stated clearly in the RN that all @since > 4.4 methods may change. > Which is the same as clearly stating that water is wet. The whole point of having releases qualified as ALPHA is to indicate their experimental status. Oleg --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
