httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Nick Kew <n...@webthing.com>
Subject Re: [DISCUSS] Dropping the E-word from mod_lua (SFW)
Date Fri, 02 Aug 2013 13:11:09 GMT

On 2 Aug 2013, at 13:41, Daniel Gruno wrote:

> In our documentation, we write the following:
> ----
> mod_lua is still in experimental state. Until it is declared stable,
> usage and behavior may change at any time, even between stable releases
> of the 2.4.x series. Be sure to check the CHANGES file before upgrading.
> ----

I hadn't realised that until today on IRC.

This is not really compatible with the back-compatibility promise of
a stable release.  Accepting that what's done is done, I'd want at
the very least to enforce the back-compatibility promise from the
point where the 'experimental' label is dropped.

> To a committer/programmer, this may seem totally sane, but to a user of
> httpd - and I sincerely hope that users are our aim in the documentaion
> - this wording screams "BACK OFF, this may explode at any given time!".

So long as an upgrade within 2.4.x might break something, that
message is absolutely necessary!

> I'd like to change the note to something along these lines:
> ----
> mod_lua is in a state of continuous development. Usage
> and behavior is subject to change at any time, even between stable
> releases of the 2.4.x series. Be sure to check the CHANGES file before
> upgrading
> ----

We tell users that when they upgrade 2.2 --> 2.4, but the opposite
when they upgrade 2.4.[x -> y].  Your proposed change buries a
critically important warning weasel-style in the smallprint!

> From a programming point of view, I can understand if there are
> reservations towards this change, but I ask you to look at it from a
> user point of view, and I hope you'll welcome this proposal for change.

Then you MUST deliver to users the promise that upgrade won't
break it!

-- 
Nick Kew

Mime
View raw message