Re: 5.4 beta
| From: | Pierre Joye | Date: | Sun, 16 Oct 2011 10:40:56 +0000 |
| Subject: | Re: 5.4 beta | ||
| References: | 1 2 3 4 5 6 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-55817@lists.php.net to get a copy of this message | ||
hi,
On Sun, Oct 16, 2011 at 4:17 AM, Stas Malyshev <smalyshev@sugarcrm.com> wrote:
> Hi!
>
> On 10/7/11 11:13 AM, Hannes Magnusson wrote:
>>
>> The UPGRADING file is also completely worthless.
>> I have no idea what is going on, as a dev, nor as a documentor.
>> Be it traits, closures, or whatever random new parameter or function was
>> added.
>> When 5.3 came around, I literally had to diff the sources to figure
>> out what was going on, I am not going through that again.
>
> I've sent a separate email about undocumented stuff but I'm kind of confused
> about UPGRADING file - what should be there and how it is related to NEWS?
> Should one ad stuff both to NEWS and UPGRADING or I as RM should add stuff
> from NEWS to UPGRADING later? Do we have process described anywhere?
You (David and you) should ensure that the UPGRADING guide is kept
updated. I would say that's not your role to do everything but to ask
the respective developers to add notes in there.
Cheers,
--
Pierre
@pierrejoye | http://blog.thepimp.net | http://www.libgd.org