On 23 June 2014 20:31, Oleg Kalnichevski <[email protected]> wrote: > On Mon, 2014-06-23 at 17:40 +0100, sebb wrote: >> On 23 June 2014 16:56, Oleg Kalnichevski <[email protected]> wrote: >> > On Mon, 2014-06-23 at 16:38 +0100, sebb wrote: >> >> On 23 June 2014 14:02, Oleg Kalnichevski <[email protected]> wrote: >> >> > Folks >> >> > >> >> > I would like to release HttpClient 4.4 alpha1 by the end of the week. >> >> > I'll be away for the first two week of July and ideally would like to >> >> > get the release done before that. >> >> > >> >> > Please have a look at the release notes and feel free to improve them: >> >> > >> >> > http://svn.apache.org/repos/asf/httpcomponents/httpclient/trunk/RELEASE_NOTES.txt >> >> >> >> A couple of comments. >> >> >> > >> > ... >> > >> >> 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. But I would expect some kind of categorisation of which methods are really experimental and which are clearly not. > Oleg > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
