hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: Coming HttpClient 4.4 alpha1 release
Date Mon, 23 Jun 2014 19:38:10 GMT
On 23 June 2014 20:31, Oleg Kalnichevski <olegk@apache.org> wrote:
> On Mon, 2014-06-23 at 17:40 +0100, sebb wrote:
>> On 23 June 2014 16:56, Oleg Kalnichevski <olegk@apache.org> wrote:
>> > On Mon, 2014-06-23 at 16:38 +0100, sebb wrote:
>> >> On 23 June 2014 14:02, Oleg Kalnichevski <olegk@apache.org> 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: dev-unsubscribe@hc.apache.org
> For additional commands, e-mail: dev-help@hc.apache.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org


Mime
View raw message