Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:55817
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.213.174 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <4E9A3EAC.6040501@sugarcrm.com>
References: <4E5B24DD.10903@sugarcrm.com>
	<op.v0yn2z06idpuyk@damnation>
	<4E671355.5060908@sugarcrm.com>
	<CAH-PCH4JaCrbuQzL+c5M6vYjfNEJXAUktLxmc7w5pfuLqdYiSQ@mail.gmail.com>
	<CADNQb0WK5sGO0EWRtALz6sM-+eFiat48VpNaEiWu5LNcPGhQcw@mail.gmail.com>
	<4E9A3EAC.6040501@sugarcrm.com>
Date: Sun, 16 Oct 2011 12:40:56 +0200
Message-ID: <CAEZPtU6hiCcCkHSh9DG7g+UJ71QM5iDQoDXPHt5qtBxp5ju5LA@mail.gmail.com>
To: Stas Malyshev <smalyshev@sugarcrm.com>
Cc: Hannes Magnusson <hannes.magnusson@gmail.com>, Ferenc Kovacs <tyra3l@gmail.com>, 
	Gustavo Lopes <glopes@nebm.ist.utl.pt>, 
	"internals@lists.php.net" <internals@lists.php.net>
Content-Type: text/plain; charset=ISO-8859-1
Subject: Re: [PHP-DEV] 5.4 beta
From: pierre.php@gmail.com (Pierre Joye)

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