Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:55738
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain analysisandsolutions.com from 166.84.1.89 cause and error)
Date: Fri, 7 Oct 2011 15:27:05 -0400
To: PHP Internals List <internals@lists.php.net>
Message-ID: <20111007192704.GA26426@panix.com>
References: <4E5B24DD.10903@sugarcrm.com>
 <op.v0yn2z06idpuyk@damnation>
 <4E671355.5060908@sugarcrm.com>
 <CAH-PCH4JaCrbuQzL+c5M6vYjfNEJXAUktLxmc7w5pfuLqdYiSQ@mail.gmail.com>
 <CADNQb0WK5sGO0EWRtALz6sM-+eFiat48VpNaEiWu5LNcPGhQcw@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
In-Reply-To: <CADNQb0WK5sGO0EWRtALz6sM-+eFiat48VpNaEiWu5LNcPGhQcw@mail.gmail.com>
User-Agent: Mutt/1.5.20 (2009-06-14)
Subject: Re: [PHP-DEV] 5.4 beta
From: danielc@analysisandsolutions.com (Daniel Convissor)

On Fri, Oct 07, 2011 at 08:13:49PM +0200, Hannes Magnusson wrote:
>
> 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.
... 
> If that doesn't happen, we wind up with more features like streams and
> filters which took 5+ years to document.

The person making changes to the language needs to ensure those changes
are documented.  That can include either writing a first draft of the
docs themselves and/or teaming up with someone on the documentation
team.  The most reliable thing to do is commit the php-src and phpdoc
changes in one commit.

At the very least, we could have a TODO file in phpdoc that contains
a simple plain text explanation of the new functionality.

"You can say that I'm a dreamer...",

--Dan

-- 
 T H E   A N A L Y S I S   A N D   S O L U T I O N S   C O M P A N Y
            data intensive web and database programming
                http://www.AnalysisAndSolutions.com/
 4015 7th Ave #4, Brooklyn NY 11232  v: 718-854-0335 f: 718-854-0409